Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

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

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 14 additions & 11 deletions admin_manual/installation/php_configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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 |
+-------------------+----------+-------------+--------------------+-----------------------------------------------+
Expand All @@ -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 |
Expand All @@ -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 |
Expand Down
Loading