Every developer has their own development environment preferences. Installing Apache and MySql are trivial and the ideal development environment will differ from one developer to another, so we consider it outside the scope of this tutorial.
If you are new to PHP web development, here are a few resources to point you in the right direction:
Composer is PHP's package manager. Make sure it's installed before you proceeding.
# Verify installation
We use git for source control. You'll need it installed too...
Local SiteAdmin instances won't work with a url like
127.0.0.1/myproject. You'll need to configure your operating system's
hostfile to point a fake domain name to your virtual host.
Though it's possible to manually install an instance of Site Administrator, we recommend using our installation script to simplify and speed up the process.
Next, upload the install script to the root directory of your project.
The script is a simply PHP file. To execute it, navigate to the file from your browser. If our project's virtual host were called
myproject.app, you would go to
The install script will create a couple of directories, and install all the necessary core modules via composer.
We advise against using the
rootdatabase user for all your SiteAdmin applications. Depending on your development environment, you can create a new database and corresponding user through a GUI (like phpMyAdmin) or directly through the command line.
Configuration files are initially created through the installer. Navigate to your project's siteadmin dashboard to complete this process.
Configuration files will vary among developers, even for the same project. Copy the
Then register your custom configuration file & virtual host with the application.
$environments = array(
'production' => array(),
'myproject.app' => array('configFile' => 'devConfig.php', 'devMode' => true, 'errorReporting' => true)
Notice the index
myproject.appis the same as the virtual host we configured for our project.