Requirements for doing a normal installation
Before a normal installation with Composer and exp:install, the machine needs:
- PHP 8.0 to 8.5 on the command line (7.4 usable without support), with dom, libxml, simplexml, xsl, mbstring, iconv, intl, session, zlib, a database extension (sqlite3 is enough) and gd or ImageMagick. Velocity also needs sockets, and pcntl and openssl in production.
- php.ini: memory_limit 64M or more, max_execution_time 30 or more, date.timezone set, file_uploads and allow_url_fopen on.
- Composer 2, a current release, run with the same PHP the site will use.
- Network access to GitHub and Packagist, from which Composer downloads the packages.
- A database: nothing to prepare for SQLite. For PostgreSQL, MongoDB, MariaDB, Oracle or MySQL, an empty database and a user that may create tables in it.
A web server is not needed for the install itself: exp:install runs on the command line, and Velocity, installed with Exponential, serves the site afterwards.
Check the machine
php -v php -m composer --version php -i | grep -E '^(memory_limit|date.timezone|max_execution_time) '
composer --version prints the Composer version and the PHP it runs with. After create-project, the console compares the machine with the extensions Velocity expects and prints the install command for your system:
php bin/php/console exp:velocity ext check
exp:install runs the setup wizard's system check as its first step and stops with the cause and the fix when something is missing. The full list: Requirements.
Contributors
- Balazs Halasy
- Ricardo Correia Maintainer
- Geir Arne Waaler Maintainer
- Graham Brookins Updated Maintainer
Comments
Add a comment