For Mac OS, we suggest installing PHP through homebrew, so you need to install it first.
Afterwards, run the following command to install PHP and MariaDB:
brew install php firstname.lastname@example.org
Furthermore, we recommend to install Sequel Pro, which is an open source database management tool for OSX - this helps to get a glance into the database.
On linux, installing PHP and Mariadb is different depending on which distribution you have. We don't yet have distribution-specific guides here yet.
Composer is the PHP dependency manager, similar to NPM for Node.js, or Maven for Java. If you do not have it installed yet, you need to install it now because it is the way to install Neos then.
curl -sS https://getcomposer.org/installer | php
By issuing this command, Composer will get downloaded as composer.phar to your working directory. We suggest to have composer installed globally, so you can simply move it to a directory within your $PATH environment:
mv composer.phar /usr/local/bin/composer
You may check your composer's version by typing “composer -V” ...
- https://getcomposer.org/download/ (see versions)
- to "self-update" your composer itself to its latest version ...
Now, this part is different depending on whether you want to start from scratch, or you have an existing project you want to work on.
To create a new project, use the following commands, which will create the base directory structure and download all dependencies.
composer create-project neos/neos-base-distribution neos-example cd neos-example
We furthermore strongly recommend to directly create a new Git repository for making the installation reproducible:
git init git add . git commit -m "TASK: Initial Commit" # optionally, also run "git remote add ..." and "git push"
To check out an existing project, simply clone it and run composer install to install all dependencies.
git clone http://YOUR-PROJECT-URL-HERE your-project cd your-project composer install
In your project directory, run the following command to start the embedded development web server:
./flow server:run # After a while, the following is shown: # Server running. # Please go to http://127.0.0.1:8081 to browse the application.