2018-03-25 12:35:05 +00:00
|
|
|
.. _example_setup_wordpress:
|
|
|
|
|
|
|
|
***************
|
|
|
|
Setup Wordpress
|
|
|
|
***************
|
|
|
|
|
|
|
|
This example will use ``git`` to install Wordpress from within the PHP container.
|
|
|
|
|
|
|
|
.. seealso:: `Official Wordpress Documentation <https://codex.wordpress.org/Installing_WordPress>`_
|
|
|
|
|
|
|
|
|
|
|
|
**Table of Contents**
|
|
|
|
|
|
|
|
.. contents:: :local:
|
|
|
|
|
|
|
|
|
|
|
|
Overview
|
|
|
|
========
|
|
|
|
|
|
|
|
The following configuration will be used:
|
|
|
|
|
|
|
|
+--------------+--------------------------+-------------+------------+-----------------------+
|
|
|
|
| Project name | VirtualHost directory | Database | TLD_SUFFIX | Project URL |
|
|
|
|
+==============+==========================+=============+============+=======================+
|
|
|
|
| my-wp | /shared/httpd/my-wp | my_wp | loc | http://my-wp.loc |
|
|
|
|
+--------------+--------------------------+-------------+------------+-----------------------+
|
|
|
|
|
|
|
|
|
|
|
|
Walk through
|
|
|
|
============
|
|
|
|
|
|
|
|
It will be ready in six simple steps:
|
|
|
|
|
|
|
|
1. Enter the PHP container
|
|
|
|
2. Create a new VirtualHost directory
|
|
|
|
3. Download Wordpress via ``git``
|
|
|
|
4. Symlink webroot directory
|
|
|
|
5. Setup DNS record
|
|
|
|
6. Visit http://my-wp.loc in your browser
|
|
|
|
|
|
|
|
|
|
|
|
.. seealso:: :ref:`available_tools`
|
|
|
|
|
|
|
|
|
|
|
|
1. Enter the PHP container
|
|
|
|
--------------------------
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
host> ./shell.sh
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
.. seealso:: :ref:`tutorial_work_inside_the_php_container`
|
|
|
|
|
|
|
|
|
|
|
|
2. Create new vhost directory
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
devilbox@php-7.0.20 in /shared/httpd $ mkdir my-wp
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
3. Download Wordpress via ``git``
|
|
|
|
---------------------------------
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
devilbox@php-7.0.20 in /shared/httpd $ cd my-wp
|
|
|
|
devilbox@php-7.0.20 in /shared/httpd/my-wp $ git clone https://github.com/WordPress/WordPress wordpress.git
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
4. Symlink webroot
|
|
|
|
------------------
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
devilbox@php-7.0.20 in /shared/httpd/my-wp $ ln -s wordpress.git/ htdocs
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
127.0.0.1 my-wp.loc
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
.. seealso::
|
2018-06-03 18:45:01 +00:00
|
|
|
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`.
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
6. Open your browser
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
Open your browser at http://my-wp.loc
|