devilbox/docs/getting-started/enter-the-php-container.rst

.. include:: /_includes/snippets/__ANNOUNCEMENTS__.rst

.. _enter_the_php_container:

***********************
Enter the PHP container
***********************

Another core feature of the Devilbox, is to be totally independent of what you have or have not
installed on your host operating system.

The Devilbox already ships with many common developer tools which are installed inside each PHP
container, so why not make use of it.

The only thing you might need to install on your host operating system is your favourite IDE or
editor to actually start coding.

.. seealso::
   If you want to find out what tools are available inside the PHP container, visit the
   following section: :ref:`available_tools`.


**Table of Contents**

.. contents:: :local:


How to enter
============

.. note::
   You can only enter the PHP container if it is running.


Linux and MacOS
---------------

On Linux and MacOS you can simply execute the provided shell script: ``shell.sh``. By doing so
it will enter you into the PHP container and bring you to ``/shared/httpd``.

.. code-block:: bash

   # Execute on the host operating system
   host> ./shell.sh

   # Now you are inside the PHP Linux container
   devilbox@php-7.0.19 in /shared/httpd $


Windows
-------

On Windows you have a different script to enter the PHP container: ``shell.bat``.
Just run it and it will enter you into the PHP container and bring you to ``/shared/httpd``.

.. code-block:: bash

   # Execute on the host operating system
   C:/Users/user1/devilbox> shell.bat

   # Now you are inside the PHP Linux container
   devilbox@php-7.0.19 in /shared/httpd $


How to become root
==================

When you enter the container with the provided scripts, you are doing so as the user ``devilbox``.
If you do need to perform any actions as root (such as installing new software), you can use
the password-less ``sudo``.

.. code-block:: bash

   # Inside the PHP Linux container as user devilbox
   devilbox@php-7.0.19 in /shared/httpd $ sudo su -

   # Now you are root and can do anything you want
   root@php-7.0.19 in /shared/httpd $

.. note::
   As this action is inside a Docker container, there is no difference between Linux, MacOS or
   Windows. Every host operating system is using the same Docker container - equal accross all
   platforms.


Tools
=====

What is available
-----------------

There are lots of tools available, for a full overview see :ref:`available_tools`.
If you think you are missing a tool, install it yourself as root, or open up an issue on github
to get it backed into the Docker image permanently.

.. seealso:: :ref:`available_tools`


How to update them
------------------

There is no need to update the tools itself. All Docker images are rebuilt every night and
automatically pushed to Docker hub to ensure versions are outdated at a maximum of 24 hours.

The only thing you have to do, is to update the Docker images itself, simply by pulling a new version.

.. seealso:: :ref:`update_the_devilbox_update_the_docker_images`


Advanced
========

This is just a short overview about the possibility to work inside the container.
If you want to dig deeper into this topic there is also a more advanced tutorial available:

.. seealso:: :ref:`work_inside_the_php_container`


Checklist
=========

* You know how to enter the PHP container on Linux, MacOS or Windows
* You know how to become ``root`` inside the PHP container
* You know what tools are available inside the PHP container
* You know how to update the tools by pulling new versions of the Docker images

.. seealso:: :ref:`troubleshooting`