Installation
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:
- Packaged Virtual Machines (Easily create/destroy environments. Full control. A little more configuration.)
Composer is PHP's package manager. Make sure it's installed before you proceeding.
# Verify installation
composer --version
We use git for source control. You'll need it installed too...
Depending on your development environment, the process of adding a virtual host will vary. Ampps offers a GUI, most other solutions will require manually configuring apache.
Local SiteAdmin instances won't work with a url like
http://localhost/myproject
or 127.0.0.1/myproject
. You'll need to configure your operating system's host
file to point a fake domain name to your virtual host.Windows
# c:\Windows\System32\drivers\etc\hosts
127.0.0.1 myproject.app
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.
You can find the install script by signing into eLink's internal Gitlab. Click on the menu icon, then navigate to
Snippets -> Explore Snippets -> SA 3 Install
.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 tohttp://myproject.app/sa.install.php
The install script will create a couple of directories, and install all the necessary core modules via composer.
We advise against using the
root
database 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.Command-Line
Configuration files are initially created through the installer. Navigate to your project's siteadmin dashboard to complete this process.
http://myproject.app/siteadmin
Configuration files will vary among developers, even for the same project. Copy the
{project_root}/siteadmin/config/config.php
file to {project_root}/siteadmin/config/devConfig.php
.Then register your custom configuration file & virtual host with the application.
{project_root}/siteadmin/config/environments.php
<?php
$environments = array(
'production' => array(),
'myproject.app' => array('configFile' => 'devConfig.php', 'devMode' => true, 'errorReporting' => true)
);
Notice the indexmyproject.app
is the same as the virtual host we configured for our project.
By now, the installation process is complete. Check out the Getting Started section to learn guide you through building your next SA3 app!
Last modified 3yr ago