khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-12-12 07:29:47 +07:00
Code Issues Packages Projects Releases Wiki Activity

fix(PHP): Add missing sysvsem extension and clarify xml extension

Browse Source 
Updated the PHP configuration documentation to:

- add missing recommended `sysvsem` extension (Fixes #13830)
- clarify the xml extension and its components.

Signed-off-by: Josh <josh.t.richards@gmail.com>
This commit is contained in:
Josh
2025-11-11 13:05:51 -05:00
committed by GitHub
parent b9031d9a4b
commit 76bac3e075
1 changed files with 14 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
admin_manual/installation/php_configuration.rst
View File

@@ -38,17 +38,20 @@ The following PHP modules **must** be installed and enabled for Nextcloud Server
- `fileinfo` (included with PHP)
- `filter` (only on Mageia and FreeBSD)
- `GD`
- `libxml` (requires Linux package `libxml2` version >= 2.7.0)
- `xml` (provides SimpleXML, XMLReader and XMLWriter; requires Linux package `libxml2` version >= 2.7.0)
- `mbstring`
- `OpenSSL` (included with PHP)
- `posix`
- `session` (included with PHP)
- `SimpleXML`
- `XMLReader`
- `XMLWriter`
- `zip`
- `zlib`
.. note::
The PHP "xml" extension is commonly packaged as `php-xml` or shown as `libxml` by OS package managers. This
extension provides the underlying libxml2 bindings and exposes SimpleXML, XMLReader and XMLWriter. Ensure the
corresponding `php-xml` (or distribution-specific) package is installed so that SimpleXML, XMLReader and XMLWriter
are available to PHP.
The `ctype`, `fileinfo`, and `OpenSSL` modules are generally included and enabled in PHP by default. Often
some of the other required modules are automatically installed by OS distribution package managers.
@@ -81,6 +84,7 @@ These modules are not required, but are highly recommended to improve functional
bcrypt will be used if Argon2 is unavailable, but if passwords were previously hashed with Argon2
(such as when migrating an existing Nextcloud Server installation to a new server environment) and this
module is missing, accounts will not be able to log-in).
- `sysvsem`: Enables System V semaphores used by Nextcloud to coordinate preview generation across PHP processes. Recommended; if missing, previews still work but may be less reliable under heavy load.
-------------------------------
Recommended PHP Caching Modules
@@ -206,7 +210,9 @@ PHP Module Quick Reference Table
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| GD | ✓ | | | Image processing |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| libxml | ✓ | | | XML parsing (libxml2 >= 2.7.0) |
| xml | ✓ | | | XML parsing (libxml2 >= 2.7.0) — provides the |
| | | | | php 'xml' extension which exposes SimpleXML, |
| | | | | XMLReader and XMLWriter |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| mbstring | ✓ | | | Multibyte character handling |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
@@ -216,12 +222,6 @@ PHP Module Quick Reference Table
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| session | ✓ | | | Session support |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| SimpleXML | ✓ | | | Simple XML parsing |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| XMLReader | ✓ | | | XML reading |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| XMLWriter | ✓ | | | XML writing |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| zip | ✓ | | | Zip file handling |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| zlib | ✓ | | | Compression and decompression |
@@ -230,6 +230,9 @@ PHP Module Quick Reference Table
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| sodium | | ✓ | | Argon2 password hashing |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| sysvsem | | ✓ | | System V semaphore support used to coordinate |
| | | | | preview generation across PHP processes. |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| ldap | | | ✓ | LDAP integration |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
| smbclient | | | ✓ | SMB/CIFS integration |