diff --git a/docs/getting_started/install_with_ddev.md b/docs/getting_started/install_with_ddev.md index 5fde0081b0..cf98c7877c 100644 --- a/docs/getting_started/install_with_ddev.md +++ b/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 diff --git a/docs/getting_started/requirements.md b/docs/getting_started/requirements.md index 1a0125969b..aa6d260070 100644 --- a/docs/getting_started/requirements.md +++ b/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). diff --git a/docs/ibexa_cloud/ddev_and_ibexa_cloud.md b/docs/ibexa_cloud/ddev_and_ibexa_cloud.md index a6d2000a3c..e2bbf82766 100644 --- a/docs/ibexa_cloud/ddev_and_ibexa_cloud.md +++ b/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 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=,IBEXA_ENVIRONMENT=production,IBEXA_APP=app ddev config --web-environment-add IBEXA_CLI_TOKEN= echo '.ddev/' >> .gitignore @@ -93,7 +93,7 @@ The following sequence of commands: ```bash ibexa_cloud project:get 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 diff --git a/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md b/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md index 6b480745cb..e73493fc6e 100644 --- a/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md +++ b/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 diff --git a/docs/infrastructure_and_maintenance/cache/persistence_cache.md b/docs/infrastructure_and_maintenance/cache/persistence_cache.md index 9cc89155e4..d3cdebca6b 100644 --- a/docs/infrastructure_and_maintenance/cache/persistence_cache.md +++ b/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 diff --git a/docs/infrastructure_and_maintenance/clustering/clustering.md b/docs/infrastructure_and_maintenance/clustering/clustering.md index f7345353b5..9be8af649c 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering.md +++ b/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. diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index fd28fa6b1a..c3f6f07315 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/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. diff --git a/docs/infrastructure_and_maintenance/img/diagram_source/server_setup.xml b/docs/infrastructure_and_maintenance/img/diagram_source/server_setup.xml index c7080d6a59..09085aed45 100644 --- a/docs/infrastructure_and_maintenance/img/diagram_source/server_setup.xml +++ b/docs/infrastructure_and_maintenance/img/diagram_source/server_setup.xml @@ -1 +1,143 @@ -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 \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/infrastructure_and_maintenance/img/server_setup.png b/docs/infrastructure_and_maintenance/img/server_setup.png index 4d295e6074..601f7ac480 100644 Binary files a/docs/infrastructure_and_maintenance/img/server_setup.png and b/docs/infrastructure_and_maintenance/img/server_setup.png differ diff --git a/docs/infrastructure_and_maintenance/performance.md b/docs/infrastructure_and_maintenance/performance.md index a9f29c21cd..6b66fe259c 100644 --- a/docs/infrastructure_and_maintenance/performance.md +++ b/docs/infrastructure_and_maintenance/performance.md @@ -16,7 +16,7 @@ If you're in a hurry, the most important recommendations on this page are: - Dump optimized Composer autoload classmap - Use a full web (Nginx/Apache) server with vhost - Avoid shared filesystems for code (Docker for Mac/Win, VirtualBox/*, Vagrant, and more), or find ways to optimize or work around the issues. -- For clustering (mainly relevant for production/staging), reduce latency to Redis/Memcached, use Varnish and [Solr](solr_overview.md). +- For clustering (mainly relevant for production/staging), reduce latency to Redis, use Varnish and [Solr](solr_overview.md). ## Client @@ -31,7 +31,7 @@ In production setups: - Compared to the built-in Symfony Proxy in PHP Varnish is much faster and is able to queue up requests for the same fresh/invalidated resource. - With [ibexa/http-cache](https://github.com/ibexa/http-cache) support for xkey and grace Varnish provides more stable performance in read/write scenarios. - Set up [[= product_name =]] in [cluster mode](clustering.md) if you need to handle bigger spikes of traffic than a single server can manage. - - See [recommendation for Memcached/Redis](#memcachedredis) and [Search](#search) below. + - See [recommendation for Redis](#redis) and [Search](#search) below. !!! note @@ -61,20 +61,15 @@ In production setups: - Keep Composer up to date. - Always dump optimized class map using `composer dump-autoload --optimize` or relevant flags on `composer install/update`. -### Memcached/Redis +### Redis -!!! note - - Redis is currently recommended over Memcached, as the latter has had big performance issues. - [Symfony v3.4.15](https://github.com/symfony/symfony/pull/28249) may have resolved this. - -- Memcached/Redis can in some cases perform better than filesystem cache even with a single server, as it offers better general performance for operations invalidating cache. +- Redis can in some cases perform better than filesystem cache even with a single server, as it offers better general performance for operations invalidating cache. - However, pure read performance is slower, especially if the next points aren't optimized. - With cache being on different node(s) than web server, make sure to try to tune latency between the two. !!! tip - Check if your cloud provider has native service for Memcached/Redis, as those might be better tuned. + Check if your cloud provider has native service for Redis, as those might be better tuned. - If you use Redis, make sure to tune it for in-memory cache usage. Its persistence feature isn't needed with cache and severely slows down execution time. - [For use with sessions](sessions.md#cluster-setup) however, persistence can be a good fit if you want sessions to survive service interruptions. diff --git a/docs/infrastructure_and_maintenance/sessions.md b/docs/infrastructure_and_maintenance/sessions.md index 9aae0b923d..0aa078c480 100644 --- a/docs/infrastructure_and_maintenance/sessions.md +++ b/docs/infrastructure_and_maintenance/sessions.md @@ -9,7 +9,7 @@ It's further enhanced in [[= product_name =]] with support for SiteAccess-aware !!! note - Use of Memcached, Redis (or experimentally PDO) as session handler is a requirement in a cluster setup, for details [see below](#cluster-setup). For an overview of the clustering feature see [Clustering](clustering.md). + Use of Redis (or experimentally PDO) as session handler is a requirement in a cluster setup, for details [see below](#cluster-setup). For an overview of the clustering feature see [Clustering](clustering.md). ## Configuration @@ -76,30 +76,6 @@ For a single server, the default file handler is preferred. See [shared sessions in the clustering guide](clustering.md#shared-sessions). -##### Handling sessions with Memcached - -To set up [[= product_name =]] using [Memcached](https://pecl.php.net/package/memcached) you need to: - -- [Configure the session save handler settings in `php.ini`](https://www.php.net/manual/en/memcached.sessions.php) -- Set `%ibexa.session.handler_id%` to `~` (null) in `config/packages/ibexa.yaml` - -Alternatively if you need to configure Memcached servers dynamically: - -- Create a Symfony service like this: - -```yaml - app.session.handler.native_memcached: - class: Ibexa\Bundle\Core\Session\Handler\NativeSessionHandler - arguments: - - '%session.save_path%' - - memcached -``` - -- Set `%ibexa.session.handler_id%` (or `SESSION_HANDLER_ID` env var) to `app.session.handler.native_memcached` -- Set `%ibexa.session.save_path%` (or `SESSION_SAVE_PATH` env var) to [`save_path` config for Memcached](https://www.php.net/manual/en/memcached.sessions.php) - -Optionally tweak [`php-memcached` session settings](https://www.php.net/manual/en/memcached.configuration.php) for things like session locking. - ##### Handling sessions with Redis To set up [[= product_name =]] using the [Redis](https://pecl.php.net/package/redis) you need to: diff --git a/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md b/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md index c64b158e55..3445b41af6 100644 --- a/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md +++ b/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md @@ -72,12 +72,6 @@ php bin/console cache:clear --env prod php bin/console cache:pool:clear cache.redis ``` -- clearing Memcached cache - -```bash -php bin/console cache:pool:clear cache.memcached -``` - - clearing the Symfony cache manually ```bash diff --git a/docs/resources/new_in_doc.md b/docs/resources/new_in_doc.md index 80cea582bf..1c82540fea 100644 --- a/docs/resources/new_in_doc.md +++ b/docs/resources/new_in_doc.md @@ -259,7 +259,7 @@ Enhanced the PHP API with the following new classes and interfaces: ### Infrastructure and maintenance - The upgrade instructions from v3.3 to v4.6 have been expanded with a section describing the [GraphQL changes in v4](https://doc.ibexa.co/en/latest/update_and_migration/from_3.3/to_4.0/#graphql) -- Ubuntu 24.04 has been added to the [list of officialy supported operating systems](https://doc.ibexa.co/en/latest/getting_started/requirements/#operating-system) +- Ubuntu 24.04 has been added to the [list of officially supported operating systems](https://doc.ibexa.co/en/latest/getting_started/requirements/#operating-system) ### PHP API diff --git a/docs/search/search_engines/solr_search_engine/install_solr.md b/docs/search/search_engines/solr_search_engine/install_solr.md index fd619b8ab5..6282f9eba4 100644 --- a/docs/search/search_engines/solr_search_engine/install_solr.md +++ b/docs/search/search_engines/solr_search_engine/install_solr.md @@ -13,11 +13,10 @@ For configuring Solr in other ways, including examples, see [Solr Cores and `sol !!! note "Solr versions" - Supported Solr versions are Solr 7 and 8. Using most recent version of Solr 7.7 or 8.11 is recommended. + Supported Solr version is Solr 8. Using the most recent version of Solr 8.11 is recommended. Download and extract Solr: -- [solr-7.7.2.tgz](http://archive.apache.org/dist/lucene/solr/7.7.2/solr-7.7.2.tgz) or [solr-7.7.2.zip](http://archive.apache.org/dist/lucene/solr/7.7.2/solr-7.7.2.zip) - [solr-8.11.2.tgz](https://www.apache.org/dyn/closer.lua/lucene/solr/8.11.2/solr-8.11.2.tgz) or [solr-8.11.2.zip](https://www.apache.org/dyn/closer.lua/lucene/solr/8.11.2/solr-8.11.2.zip) Copy the necessary configuration files. In the example below from the root of your project to the place you extracted Solr: