2018-07-10 18:58:45 +00:00
|
|
|
.. include:: /_includes/all.rst
|
2019-03-07 15:35:54 +00:00
|
|
|
.. include:: /_includes/snippets/__ANNOUNCEMENTS__.rst
|
2018-07-10 18:58:45 +00:00
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
.. _example_setup_zend:
|
|
|
|
|
|
|
|
**********
|
|
|
|
Setup Zend
|
|
|
|
**********
|
|
|
|
|
|
|
|
This example will use ``composer`` to install Zend from within the PHP container.
|
|
|
|
|
2019-03-07 13:48:17 +00:00
|
|
|
.. important::
|
|
|
|
Using ``composer`` requires the underlying file system to support symlinks. If you
|
|
|
|
use **Docker Toolbox** you need to explicitly allow/enable this.
|
|
|
|
See below for instructions:
|
|
|
|
|
|
|
|
* Docker Toolbox and :ref:`howto_docker_toolbox_and_the_devilbox_windows_symlinks`
|
|
|
|
|
2018-07-10 18:58:45 +00:00
|
|
|
.. seealso:: |ext_lnk_example_zend_documentation|
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
**Table of Contents**
|
|
|
|
|
|
|
|
.. contents:: :local:
|
|
|
|
|
|
|
|
|
|
|
|
Overview
|
|
|
|
========
|
|
|
|
|
|
|
|
The following configuration will be used:
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
+--------------+--------------------------+-------------+------------+---------------------------------------------+
|
|
|
|
| Project name | VirtualHost directory | Database | TLD_SUFFIX | Project URL |
|
|
|
|
+==============+==========================+=============+============+=============================================+
|
|
|
|
| my-zend | /shared/httpd/my-zend | n.a. | loc | http://my-zend.loc |br| https://my-zend.loc |
|
|
|
|
+--------------+--------------------------+-------------+------------+---------------------------------------------+
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
* Inside the Devilbox PHP container, projects are always in ``/shared/httpd/``.
|
|
|
|
* On your host operating system, projects are by default in ``./data/www/`` inside the
|
|
|
|
Devilbox git directory. This path can be changed via :ref:`env_httpd_datadir`.
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
Walk through
|
|
|
|
============
|
|
|
|
|
|
|
|
It will be ready in six simple steps:
|
|
|
|
|
|
|
|
1. Enter the PHP container
|
|
|
|
2. Create a new VirtualHost directory
|
|
|
|
3. Install Zend via ``composer``
|
|
|
|
4. Symlink webroot directory
|
|
|
|
5. Setup DNS record
|
|
|
|
6. Visit http://my-wp.loc in your browser
|
|
|
|
|
|
|
|
|
|
|
|
1. Enter the PHP container
|
|
|
|
--------------------------
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
All work will be done inside the PHP container as it provides you with all required command line
|
|
|
|
tools.
|
|
|
|
|
|
|
|
Navigate to the Devilbox git directory and execute ``shell.sh`` (or ``shell.bat`` on Windows) to
|
|
|
|
enter the running PHP container.
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
host> ./shell.sh
|
2018-03-25 12:35:05 +00:00
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
.. seealso::
|
|
|
|
* :ref:`enter_the_php_container`
|
|
|
|
* :ref:`work_inside_the_php_container`
|
|
|
|
* :ref:`available_tools`
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
2. Create new vhost directory
|
|
|
|
-----------------------------
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
The vhost directory defines the name under which your project will be available. |br|
|
|
|
|
( ``<vhost dir>.TLD_SUFFIX`` will be the final URL ).
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
devilbox@php-7.0.20 in /shared/httpd $ mkdir my-zend
|
2018-03-25 12:35:05 +00:00
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
.. seealso:: :ref:`env_tld_suffix`
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
3. Install Zend via ``composer``
|
|
|
|
--------------------------------
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
Navigate into your newly created vhost directory and install Zend with ``composer``.
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
devilbox@php-7.0.20 in /shared/httpd $ cd my-zend
|
|
|
|
devilbox@php-7.0.20 in /shared/httpd/my-zend $ composer create-project --prefer-dist zendframework/skeleton-application zend
|
2018-03-25 12:35:05 +00:00
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
How does the directory structure look after installation:
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
devilbox@php-7.0.20 in /shared/httpd/my-zend $ tree -L 1
|
|
|
|
.
|
|
|
|
└── zend
|
|
|
|
|
|
|
|
1 directory, 0 files
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
4. Symlink webroot
|
|
|
|
------------------
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
Symlinking the actual webroot directory to ``htdocs`` is important. The web server expects every
|
|
|
|
project's document root to be in ``<vhost dir>/htdocs/``. This is the path where it will serve
|
|
|
|
the files. This is also the path where your frameworks entrypoint (usually ``index.php``) should
|
|
|
|
be found.
|
|
|
|
|
|
|
|
Some frameworks however provide its actual content in nested directories of unknown levels.
|
|
|
|
This would be impossible to figure out by the web server, so you manually have to symlink it back
|
|
|
|
to its expected path.
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
devilbox@php-7.0.20 in /shared/httpd/my-zend $ ln -s zend/public/ htdocs
|
2018-03-25 12:35:05 +00:00
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
How does the directory structure look after symlinking:
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
devilbox@php-7.0.20 in /shared/httpd/my-zend $ tree -L 1
|
|
|
|
.
|
|
|
|
├── zend
|
|
|
|
└── htdocs -> zend/public
|
|
|
|
|
|
|
|
2 directories, 0 files
|
|
|
|
|
|
|
|
As you can see from the above directory structure, ``htdocs`` is available in its expected
|
|
|
|
path and points to the frameworks entrypoint.
|
|
|
|
|
2019-03-07 13:48:17 +00:00
|
|
|
.. important::
|
|
|
|
When using **Docker Toolbox**, you need to **explicitly allow** the usage of **symlinks**.
|
|
|
|
See below for instructions:
|
|
|
|
|
|
|
|
* Docker Toolbox and :ref:`howto_docker_toolbox_and_the_devilbox_windows_symlinks`
|
|
|
|
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
5. DNS record
|
|
|
|
-------------
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
If you **have** Auto DNS configured already, you can skip this section, because DNS entries will
|
|
|
|
be available automatically by the bundled DNS server.
|
|
|
|
|
|
|
|
If you **don't have** 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):
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
:caption: /etc/hosts
|
|
|
|
|
2018-06-03 18:45:01 +00:00
|
|
|
127.0.0.1 my-zend.loc
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
.. seealso::
|
2018-07-03 13:47:58 +00:00
|
|
|
|
2018-07-08 10:23:57 +00:00
|
|
|
* :ref:`howto_add_project_hosts_entry_on_mac`
|
|
|
|
* :ref:`howto_add_project_hosts_entry_on_win`
|
2018-07-03 13:47:58 +00:00
|
|
|
* :ref:`setup_auto_dns`
|
2018-03-25 12:35:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
6. Open your browser
|
|
|
|
--------------------
|
|
|
|
|
2018-07-30 07:32:40 +00:00
|
|
|
Open your browser at http://my-zend.loc or https://my-zend.loc
|
|
|
|
|
|
|
|
.. seealso:: :ref:`setup_valid_https`
|