IBX-10245: Document 5.0 requirements (#2807)

* IBX-10245: Document 5.0 requirements

---------

Co-authored-by: Marek Nocoń <[email protected]>

Author: dabrt

docs/getting_started/install_with_ddev.md

@@ -31,7 +31,7 @@ mkdir my-ddev-project && cd my-ddev-project
 Next, configure your DDEV environment with the following command:
 
 ```bash
-ddev config --project-type=php --php-version 8.3 --nodejs-version 20 --docroot=public
+ddev config --project-type=php --php-version 8.3 --nodejs-version 22 --docroot=public
 ```
 
 This command sets the project type to PHP, the PHP version to 8.3, the document root to `public` directory, and creates the document root if it doesn't exist.
@@ -49,7 +49,7 @@ ddev config --database=postgres:14
 To use MySQL instead, run the following command:
 
 ```bash
-ddev config --database=mysql:8.0
+ddev config --database=mysql:8.4
 ```
 
 You can also use other versions of MariaDB, Mysql or PostgreSQL.
@@ -415,7 +415,7 @@ If the local project needs to answer to real production domains (for example, to
 
 You can use DDEV to locally simulate a production cluster.
 
-- See [Clustering with DDEV](clustering_with_ddev.md) to add Elasticsearch, Solr, Redis, or Memcached to your DDEV installation.
+- See [Clustering with DDEV](clustering_with_ddev.md) to add Elasticsearch, Solr, or Redis to your DDEV installation.
 - See [DDEV and Ibexa Cloud](ddev_and_ibexa_cloud.md) to locally run an [[= product_name =]] project by using DDEV.
 
 ## Stop or remove the project

docs/getting_started/requirements.md

@@ -17,7 +17,7 @@ The following server requirements cover both running the software on-premise and
     For running on [[[= product_name_cloud =]]](https://www.ibexa.co/products/ibexa-cloud), where recommended configuration and support is provided out of the box, see separate [[[= product_name_cloud =]] section](#ibexa-cloud-requirements-and-setup) for further reading on its requirements.
 
 The minimal setup requires PHP, MySQL/MariaDB, Apache/Nginx, Node.js and `yarn`.
-Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached, NFS/EFS/S3 and Solr/Elasticsearch in a [clustered setup](clustering.md).
+For production setups it's recommended that you use Varnish/Fastly, Redis, NFS/EFS/S3 and Solr/Elasticsearch in a [clustered setup](clustering.md).
 
 !!! caution "Recommended versions"
 
@@ -34,10 +34,7 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
     |Name|Version|
     |---|---|
-    |Debian 10 "Buster" |10.0-10.13+|
     |Debian 11 "Bullseye"|11.0-11.7+|
-    |Ubuntu  "Focal Fossa" | 20.04 |
-    |Ubuntu "Jammy Jellyfish"| 22.04 |
     |Ubuntu "Noble Numbat"| 24.04 |
     |RHEL / CentOS / CentOS Stream | 8.1-9.5+ |
 
@@ -75,7 +72,7 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
 === "[[= product_name =]] v5.0"
 
-    - Nginx 1.18-1.25+
+    - Nginx 1.27+
     - Apache 2.4 (with required modules `mod_rewrite`, `mod_env` and recommended: `mod_setenvif`, `mod_expires`;
     event MPM is recommended, if you need to use prefork you also need the `mod_php` module)
 
@@ -101,8 +98,8 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
 === "[[= product_name =]] v5.0"
 
-    - MariaDB 10.3-10.11+
-    - MySQL 8.0
+    - MariaDB 10.11+
+    - MySQL 8.4
     - PostgreSQL 14
 
     If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
@@ -158,7 +155,6 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
     - `php-mysql` (`php-mysqlnd`) or `php-pgsql`
     - `php-xml`
     - `php-mbstring`
-    - `php-json`
     - `php-process` (on RHEL/CentOS)
     - `php-intl`
     - `php-curl`
@@ -202,7 +198,7 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
 === "[[= product_name =]] v5.0"
 
-    - `php-redis` or `php-memcached`
+    - `php-redis`
 
 === "[[= product_name =]] v4.6"
 
@@ -216,10 +212,8 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
 === "[[= product_name =]] v5.0"
 
-    - For content search, Solr 7.7 LTS or Solr 8, recommended 8.11.1 or higher.
+    - For content search, Solr 8.11.1 or higher.
     Alternatively, Elasticsearch 7.16.2 or higher 7.x version.
-    - The above solutions require Oracle Java/Open JDK. The minimum requirement is 8 LTS, recommended 11 LTS.
-    Newer versions aren't supported.
 
 === "[[= product_name =]] v4.6"
 
@@ -287,7 +281,7 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 === "[[= product_name =]] v5.0"
 
     - Linux NFS or S3/EFS (for IO, aka binary files stored in content repository, not supported with legacy)
-    - Redis 4.0+ or 5.0+ (separate instances for session and cache, both using a `volatile-*` [eviction policy](https://redis.io/docs/latest/develop/reference/eviction/), session instance configured for persistence) or [Memcached](https://memcached.org/) 1.5 or higher
+    - Redis 7.2+ (separate instances for session and cache, both using a `volatile-*` [eviction policy](https://redis.io/docs/latest/develop/reference/eviction/), session instance configured for persistence)
     - [Varnish](http://varnish-cache.org/) 6.0LTS or 7.1 with [varnish-modules](https://github.com/varnish/varnish-modules/blob/master/README.md) or [Fastly](https://www.fastly.com/) using [the provided bundle](http_cache.md) (for HTTP Cache)
 
     If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
@@ -329,7 +323,7 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
 === "[[= product_name =]] v5.0"
 
-    - Composer: recent 2.7 version
+    - Composer: recent 2.8 version
 
 === "[[= product_name =]] v4.6"
 
@@ -343,7 +337,7 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
 === "[[= product_name =]] v5.0"
 
-    - `Node.js` 18+
+    - `Node.js` 22+
     - `yarn` 1.15.2+
 
     If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
@@ -408,8 +402,8 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,
 
     For example:
 
-    - Platform.sh provides Redis support for versions 3.2, 4.0 and 5.0. [[= product_name =]] supports Redis version 4.0 or higher, and recommends 5.0.
-    As a result, Redis is supported on [[= product_name_cloud =]] in versions 4.0 and 5.0, but 5.0 is recommended.
+    - Platform.sh provides Redis support for versions 7.2, 7.0, and 6.2. [[= product_name =]] supports Redis version 7.2.
+    As a result, Redis is supported on [[= product_name_cloud =]] in versions 7.2.
 
     Features or services supported by [[= product_name =]] but not covered by Platform.sh may be possible by means of a [custom integration](#custom-integrations).
 

docs/ibexa_cloud/ddev_and_ibexa_cloud.md

@@ -53,7 +53,7 @@ See [`ibexa_cloud help get`](https://docs.platform.sh/administration/cli.html#3-
 
 ```bash
 ibexa_cloud project:get <project-ID> my-ddev-project && cd my-ddev-project
-ddev config --project-type=php --php-version 8.1 --web-environment-add COMPOSER_AUTH='',DATABASE_URL=mysql://db:db@db:3306/db
+ddev config --project-type=php --php-version 8.3 --web-environment-add COMPOSER_AUTH='',DATABASE_URL=mysql://db:db@db:3306/db
 ddev config --web-environment-add IBEXA_PROJECT=<project-ID>,IBEXA_ENVIRONMENT=production,IBEXA_APP=app
 ddev config --web-environment-add IBEXA_CLI_TOKEN=<api-token>
 echo '.ddev/' >> .gitignore
@@ -93,7 +93,7 @@ The following sequence of commands:
 
 ```bash
 ibexa_cloud project:get <project-ID> my-ddev-project && cd my-ddev-project
-ddev config --project-type=php --php-version 8.1 --docroot=public --web-environment-add DATABASE_URL=mysql://db:db@db:3306/db
+ddev config --project-type=php --php-version 8.3 --docroot=public --web-environment-add DATABASE_URL=mysql://db:db@db:3306/db
 echo '.ddev/' >> .gitignore
 ddev start
 ddev composer config --global http-basic.updates.ibexa.co <installation-key> <token-password>

docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md

@@ -452,7 +452,7 @@ The output for this command should look similar to this:
 
 ```
     HTTP/1.1 200 OK
-    Server: nginx/1.20.0
+    Server: nginx/1.27.0
     Content-Type: application/vnd.fos.user-context-hash
     Transfer-Encoding: chunked
     Connection: keep-alive
@@ -480,7 +480,7 @@ The output :
 
 ```
 HTTP/1.1 200 OK
-Server: nginx/1.20.0
+Server: nginx/1.27.0
 Content-Type: text/html; charset=UTF-8
 Transfer-Encoding: chunked
 Connection: keep-alive
@@ -533,7 +533,7 @@ The output is:
 
 ```
 HTTP/1.1 200 OK
-Server: nginx/1.20.0
+Server: nginx/1.27.0
 Content-Type: text/html; charset=UTF-8
 Transfer-Encoding: chunked
 Connection: keep-alive
@@ -561,7 +561,7 @@ Output:
 
 ```
 HTTP/1.1 200 OK
-Server: nginx/1.20.0
+Server: nginx/1.27.0
 Content-Type: text/html; charset=UTF-8
 Transfer-Encoding: chunked
 Connection: keep-alive

docs/infrastructure_and_maintenance/cache/persistence_cache.md

@@ -12,7 +12,7 @@ Persistence cache can best be described as an implementation of `SPI\Persistence
 
 As shown in the illustration, this is done in the exact same way as the event layer is a custom implementation of `API\Repository` decorating the main repository.
 In the case of persistence cache, instead of sending events on calls passed on to the decorated implementation, most of the load calls are cached, and calls that perform changes purge the affected caches.
-Cache handlers *(for example, Memcached, Redis, or Filesystem)* can be configured using Symfony configuration.
+Cache handlers *(for example, Redis, or Filesystem)* can be configured using Symfony configuration.
 For details on how to reuse this Cache service in your own custom code, see below.
 
 ## Transparent cache
@@ -47,10 +47,10 @@ To see where and how to contribute additional caches, refer to the [source code]
 !!! note
 
     Current implementation uses Symfony cache.
-    It technically supports the following cache backends: [APCu, Array, Chain, Doctrine, Filesystem, Memcached, PDO & Doctrine DBAL, Php Array, Proxy, Redis]([[= symfony_doc =]]/components/cache/cache_pools.html#creating-cache-pools).
-    [[= product_name =]] officially supports only using Filesystem for single server and Redis or Memcached for clustered setups.
+    It technically supports the following cache backends: [APCu, Array, Chain, Doctrine, Filesystem, PDO & Doctrine DBAL, Php Array, Proxy, Redis]([[= symfony_doc =]]/components/cache/cache_pools.html#creating-cache-pools).
+    [[= product_name =]] officially supports only using Filesystem for single server and Redis for clustered setups.
 
-Use of Memcached or Redis as shared cache back end is a requirement for use in clustering setup.
+Use of Redis as shared cache back end is a requirement for use in clustering setup.
 For an overview of this feature, see [Clustering](clustering.md).
 Filesystem adapters, for example, are **not** intended to be used over a shared filesystem.
 
@@ -210,79 +210,9 @@ Several cloud providers have managed services that are easier to set up, handle
     If you use Platform.sh Enterprise you can benefit from the Redis Sentinel across three nodes for great fault tolerance.
     Platform.sh Professional and lower versions offer Redis in single instance mode only.
 
-### Memcached
-
-[Memcached, a distributed caching solution](http://memcached.org/) is a cache solution that is supported for clustering use, as an alternative to Redis.
-
-See [Memcached Cache Adapter in Symfony documentation]([[= symfony_doc =]]/components/cache/adapters/memcached_adapter.html#configure-the-connection) for information on how to configure Memcached.
-
-
-#### Supported Adapters
-
-There is one Memcached adapter available out of the box.
-
-##### `Symfony\Component\Cache\Adapter\MemcachedAdapter`
-
-**Pros**: Memcached is able to handle much more concurrent load by design (multi threaded), and typically uses far less memory than Redis in general due to a simpler data structure.
-
-**Cons**: 1.5-2x more lookups to the back-end cache server then `RedisTagAwareAdapter`.
-Depending on the number of lookups and latency to cache server this might affect page load time.
-
-#### Adjusting configuration
-
-Out of the box in `config/packages/cache_pool/cache.memcached.yaml` you can find a default example that can be used.
-
-!!! note "[[= product_name_cloud =]]"
-
-    For [[= product_name_cloud =]]/Platform.sh: This is automatically configured in `vendor/ibexa/core/src/bundle/Core/DependencyInjection/IbexaCoreExtension.php` if you have enabled Memcached as `cache` Platform.sh service.
-
-For anything else, you can enable it with environment variables detected automatically by `vendor/ibexa/core/src/bundle/Core/DependencyInjection/IbexaCoreExtension.php`.
-For instance, if you set the following environment variables `export CACHE_POOL="cache.memcached" CACHE_DSN="user:pass@localhost?weight=33"`, it results in config like this:
-
-``` yaml
-services:
-    cache.memcached:
-        parent: cache.adapter.memcached
-        tags:
-            - name: cache.pool
-              clearer: cache.app_clearer
-              provider: 'memcached://user:pass@localhost?weight=33'
-              # Default CACHE_NAMESPACE value, see bin/config/cache_pool/cache.redis.yaml for usage with e.g. multi repo.
-              namespace: 'ez'
-```
-
-See `config/default_parameters.yaml` and `config/cache_pool/cache.memcached.yaml` for further details on `CACHE_POOL`, `CACHE_DSN` and `CACHE_NAMESPACE`.
-
-!!! caution "Clearing Memcached cache"
-
-    The regular `php bin/console cache:clear` command doesn't clear Memcached persistence cache.
-    Use a dedicated Symfony command to clear the pool you have configured: `php bin/console cache:pool:clear cache.memcached`.
-
-
-!!! caution "Connection errors issue"
-
-    If Memcached does display connection errors when using the default (ascii) protocol, then switching to binary protocol *(in the configuration and Memcached daemon)* should resolve the issue.
-
-!!! note
-
-    Memcached must not be bound to the local address if clusters are in use, or user logins fail.
-    To avoid this, in `/etc/memcached.conf` take a look under `# Specify which IP address to listen on. The default is to listen on all IP addresses`
-
-    For development environments, change the address below this comment in `/etc/memcached.conf` to `-l 0.0.0.0`
-
-    For production environments, follow this more secure instruction from the Memcached man:
-
-    > -l <addr>
-
-    > Listen on <addr>; default to INADDR\_ANY. <addr> may be specified as host:port.
-    If you don't specify a port number, the value you specified with -p or -U is used.
-    You may specify multiple addresses separated by comma or by using -l multiple times.
-    This is an important option to consider as there is no other way to secure the installation.
-    Binding to an internal or firewalled network interface is suggested.
-
 ## Using cache service
 
-Using the internal cache service allows you to use an interface and without caring whether the system is configured to place the cache in Memcached or on File system.
+Using the internal cache service allows you to use an interface and without caring whether the system is configured to place the cache in Redis or on File system.
 And as [[= product_name =]] requires that instances use a cluster-aware cache in cluster setup, you can safely assume your cache is shared *(and invalidated)* across all web servers.
 
 !!! note

docs/infrastructure_and_maintenance/clustering/clustering.md

@@ -13,12 +13,12 @@ The parts illustrate the different roles needed for a successful cluster setup.
 
 ![Server setup for clustering](server_setup.png)
 
-The number of web servers, Memcached/Redis, Solr, Varnish, Database, and NFS servers, but also whether some servers play several of these roles (typically running Memcached/Redis across the web server), is up to you and your performance needs.
+The number of web servers, Redis, Solr, Varnish, Database, and NFS servers, but also whether some servers play several of these roles (typically running Redis across the web server), is up to you and your performance needs.
 
 The minimal requirements are:
 
 - [Shared HTTP cache (using Varnish)](reverse_proxy.md#using-varnish-or-fastly)
-- [Shared persistence cache](#shared-persistence-cache) and [sessions](#shared-sessions) (using Redis or Memcached)
+- [Shared persistence cache](#shared-persistence-cache) and [sessions](#shared-sessions) (using Redis)
 - Shared database (using MySQL/MariaDB)
 - [Shared binary files](#shared-binary-files) (using NFS, or S3)
 
@@ -35,21 +35,20 @@ It's also recommended to use:
 ### Shared persistence cache
 
 Redis is the recommended cache solution for clustering.
-An alternative solution is using Memcached.
 
 See [persistence cache documentation](persistence_cache.md#persistence-cache-configuration) on information on how to configure them.
 
 ### Shared sessions
 
 For a [cluster](clustering.md) setup you need to configure sessions to use a back end that is shared between web servers.
-The main options out of the box in Symfony are the native PHP Memcached or PHP Redis session handlers, alternatively there is Symfony session handler for PDO (database).
+The main option out of the box in Symfony is the PHP Redis session handler, alternatively there is Symfony session handler for PDO (database).
 
 To avoid concurrent access to session data from front-end nodes, if possible you should either:
 
 - Enable [Session locking](https://www.php.net/manual/en/features.session.security.management.php#features.session.security.management.session-locking)
 - Use "Sticky Session", aka [Load Balancer Persistence](https://en.wikipedia.org/wiki/Load_balancing_%28computing%29#Persistence)
 
-Session locking is available with `php-memcached`, and with `php-redis` (v4.2.0 and higher).
+Session locking is available with `php-redis` (v4.2.0 and higher).
 
 On [[= product_name_cloud =]] (and Platform.sh) Redis is preferred and supported.
 

docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md

@@ -120,37 +120,3 @@ You can now check whether Redis works.
 For example, the `ddev redis-cli MONITOR` command returns outputs, for example, `"SETEX" "ezp:`, `"MGET" "ezp:`, `"SETEX" "PHPREDIS_SESSION:`, or `"GET" "PHPREDIS_SESSION:`, while navigating into the website, in particular the back office.
 
 See [Redis commands](https://redis.io/docs/latest/commands/) for more details such as information about the [`MONITOR`](https://redis.io/docs/latest/commands/monitor/) command used in the previous example.
-
-### Install Memcached
-
-First, if not already there, append the following [new service](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/sessions/#handling-sessions-with-memcached) to `config/services.yaml`:
-
-```yaml
-    app.session.handler.native_memcached:
-        class: Ibexa\Bundle\Core\Session\Handler\NativeSessionHandler
-        arguments:
-            - '%session.save_path%'
-            - memcached
-```
-
-Second, install and set up the add-on.
-The following sequence of commands:
-
-1. Adds the Memcached container.
-1. Sets Memcached as the cache pool.
-1. Sets Memcached as the session handler.
-1. Restarts the DDEV cluster and clears application cache.
-
-```bash
-ddev add-on get ddev/ddev-memcached
-ddev config --web-environment-add CACHE_POOL=cache.memcached
-ddev config --web-environment-add CACHE_DSN=memcached
-ddev config --web-environment-add SESSION_HANDLER_ID=app.session.handler.native_memcached
-ddev config --web-environment-add SESSION_SAVE_PATH=memcached:11211
-ddev restart
-ddev php bin/console cache:clear
-```
-
-You can now check whether everything went right.
-
-For example, the `watch 'ddev exec netcat -w1 memcached 11211 <<< "stats" | grep "cmd_.et "'` command checks whether the `web` service can access the `memcached` service, and displays the increase of `cmd_get` and `cmd_set` while navigating into the website.