From 13090376431b8aafba6f7420cae71a02406857d5 Mon Sep 17 00:00:00 2001 From: cytopia Date: Tue, 15 May 2018 00:30:00 +0200 Subject: [PATCH] How to install Photon CMS --- docs/examples/setup-phalcon.rst | 2 +- docs/examples/setup-photon-cms.rst | 109 +++++++++++++++++++++++++++++ docs/index.rst | 1 + docs/readings/available-tools.rst | 2 + 4 files changed, 113 insertions(+), 1 deletion(-) create mode 100644 docs/examples/setup-photon-cms.rst diff --git a/docs/examples/setup-phalcon.rst b/docs/examples/setup-phalcon.rst index eb8df11e..4d7511fd 100644 --- a/docs/examples/setup-phalcon.rst +++ b/docs/examples/setup-phalcon.rst @@ -74,7 +74,7 @@ It will be ready in six simple steps: .. code-block:: bash - devilbox@php-7.0.20 in /shared/httpd/my-pahlcon $ ln -s phalconphp/public/ htdocs + devilbox@php-7.0.20 in /shared/httpd/my-phalcon $ ln -s phalconphp/public/ htdocs 5. DNS record diff --git a/docs/examples/setup-photon-cms.rst b/docs/examples/setup-photon-cms.rst new file mode 100644 index 00000000..604cce76 --- /dev/null +++ b/docs/examples/setup-photon-cms.rst @@ -0,0 +1,109 @@ +.. _example_setup_photon_cms: + +**************** +Setup Photon CMS +**************** + +This example will use ``photon`` cli to install Photon CMS from within the PHP container. + +.. seealso:: `Official Photon CMS Documentation `_ + + +**Table of Contents** + +.. contents:: :local: + + +Overview +======== + +The following configuration will be used: + ++--------------+--------------------------+-------------+------------+-----------------------+ +| Project name | VirtualHost directory | Database | TLD_SUFFIX | Project URL | ++==============+==========================+=============+============+=======================+ +| my-photon | /shared/httpd/my-photon | blog | loc | http://my-photon.loc | ++--------------+--------------------------+-------------+------------+-----------------------+ + +.. note:: The database is created automatically by ``photon`` cli. + + +Walk through +============ + +It will be ready in six simple steps: + +1. Enter the PHP container +2. Create a new VirtualHost directory +3. Install Photon +4. Symlink webroot directory +5. Setup DNS record +6. Visit http://my-photon.loc in your browser + + +.. seealso:: :ref:`available_tools` + + +1. Enter the PHP container +-------------------------- + +.. code-block:: bash + + host> ./shell.sh + +.. seealso:: :ref:`tutorial_work_inside_the_php_container` + + +2. Create new vhost directory +----------------------------- + +.. code-block:: bash + + devilbox@php-7.0.20 in /shared/httpd $ mkdir my-photon + + +3. Install Photon +------------------ + +During the installation it will ask for a MySQL username and password. +Provide a pair of credentials that has permissions to create a database or create the database +itself beforehand. + +.. code-block:: bash + + devilbox@php-7.0.20 in /shared/httpd $ cd my-photon + devilbox@php-7.0.20 in /shared/httpd/my-photon $ photon new blog + ...What is your mysql username? root + ...What is your mysql password? + + +4. Symlink webroot +------------------ + +.. code-block:: bash + + devilbox@php-7.0.20 in /shared/httpd/my-photon $ ln -s blog/public/ htdocs + + +5. DNS record +------------- + +If you do not have :ref:`global_configuration_auto_dns` configured, you will need to add the +following line to your host operating systems ``/etc/hosts`` file +(or ``C:\Windows\System32\drivers\etc`` on Windows): + +.. code-block:: bash + :caption: /etc/hosts + :name: /etc/hosts + + 127.0.0.1 my-photon.loc + +.. seealso:: + For in-depth info about adding DNS records on Linux, Windows or MacOS see: + :ref:`project_configuration_dns_records` or :ref:`global_configuration_auto_dns`. + + +6. Open your browser +-------------------- + +Open your browser at http://my-photon.loc diff --git a/docs/index.rst b/docs/index.rst index f58b44c3..45f8a622 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -91,6 +91,7 @@ host is ready to be served with your custom domain. examples/setup-joomla examples/setup-laravel examples/setup-phalcon + examples/setup-photon-cms examples/setup-symfony examples/setup-wordpress examples/setup-yii diff --git a/docs/readings/available-tools.rst b/docs/readings/available-tools.rst index caa11f22..218cda85 100644 --- a/docs/readings/available-tools.rst +++ b/docs/readings/available-tools.rst @@ -60,6 +60,8 @@ The PHP container is your workhorse and these are your tools: +----------------------+-----------------------------------------------------------------------------------+ | ``phpcbf`` | `PHP Code Beautifier and Fixer `_ | +----------------------+-----------------------------------------------------------------------------------+ +| ``photon`` | `Photon CMS cli `_ | ++----------------------+-----------------------------------------------------------------------------------+ | ``redis*`` | Various Redis client tools | +----------------------+-----------------------------------------------------------------------------------+ | ``sass`` | `Sass `_ |