Skip to the content
Documentation

Requirements for doing a normal installation

No ratings yet

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

Comments

Add a comment

Comments are read by a moderator before they appear.