Now that you intend to develop for PrestaShop, you are better off keeping all your development work on your machine. The main advantage is that it makes it possible for you to entirely bypass the process of uploading your file on your online server in order to test it. Another advantage is that a local test environment enables you to test code without the risk of breaking your production store. Have a local environment is the essential first step in the path of web development.
Read System Requirements.
Installing any web-application locally requires that you first install the adequate environment, namely the Apache web server, the PHP language interpreter, the MySQL database server, and ideally the phpMyAdmin tool. This is called an *AMP package: Apache+MySQL+PHP and the operating system, giving WAMP (Windows+Apache+MySQL+PHP), MAMP (Mac OS X+…) and LAMP (Linux+…). Since all of the items packaged are open-source, these installers are most of the time free.
Here is a selection of free AMP installers:
Open the phpMyAdmin tool using your browser. Its location depends on the AMP pack you chose:
In the “Databases” tab, indicate the database name you want and validate by clicking on the “Create a database” button.
The source code of PrestaShop is hosted on the Official PrestaShop GitHub Repository.
You can find all the released versions of PrestaShop here: PrestaShop releases.
PrestaShop comes in two “flavors”:
Prefer cloning the repository using git for the development version.
If you intend to work on PrestaShop itself, we suggest using Git to clone the source code of PrestaShop from the GitHub repository.
As stated above, if you decide to work on PrestaShop itself, it’s best to clone the PrestaShop repository and work using git. Depending on the version of PrestaShop you want to work on, you will need to choose the right branch:
Clone the repository using Git or extract the zip package in a
prestashop folder inside the document folder of the AMP installer you chose:
This step is only needed if you downloaded the development version.
Use composer to download the project’s dependencies:
cd /path/to/prestashop composer install
PrestaShop needs recursive write permissions on several directories:
To ease up your life on a development environment, we suggest to either:
chownall PrestaShop files to “youruser:_www”.
Never do that in production! Carefully change permissions folder by folder instead.
Open the PrestaShop installer and follow its instructions.
Depending on whether you downloaded a release package or cloned the repository, the route to the installer will be slightly different:
You can read the Getting Started guide for more details.
You may find this error message the first time you open up the Back Office.
This problem may arise in case-insensitive file systems like MacOS due to a misconfiguration. Check your Apache configuration and make sure that the root directory path to your PrestaShop matches the capitalization of the actual system path exactly. A typical error is for example having a folder named
/path/to/PrestaShop (capital P, capital S) and then configuring it in Apache as
/path/to/Prestashop (missing the capital S).