2020-05-25 AC: Release-8.2.0.

andrewscaya · andrewscaya · commit 7c772ab4a171 · 2020-06-12T18:09:45.000-04:00
diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
@@ -26,10 +26,13 @@ To get the status of the PHP-FPM server::
 These commands apply to all the main services that are included within all *Linux for PHP* images :
 
 * Apache :           /etc/init.d/httpd [start/stop/status]
+* nginx :            /etc/init.d/nginx [start/stop/status]
 * MariaDB (MySQL) :  /etc/init.d/mysql [start/stop/status]
 * PostgreSQL :       /etc/init.d/postgresql [start/stop/status]
 * OpenLDAP :         /etc/init.d/slapd [start/stop/status]
 * Exim Mail :        /etc/init.d/exim [start/stop/status]
+* MongoDB :          /etc/init.d/mongod [start/stop/status]
+* OpenSSH :          /etc/init.d/sshd [start/stop/status]
 
 .. note:: All configuration files can be found within the ``/etc`` directory.
 
@@ -46,17 +49,17 @@ When using a *Linux for PHP* container in detached mode, it is possible to autom
 If you wish to start a container with only the *MariaDB (MySQL)* server running, you would enter the following command
 when invoking the container::
 
-    $ docker run -dit asclinux/linuxforphp-8.1:7.2.12-nts bash -c "lfphp --mysql"
+    $ docker run -dit asclinux/linuxforphp-8.2-ultimate:7.4-nts bash -c "lfphp --mysql"
 
 The available services are :
 
-* Apache ('--apache')
-* Exim Mail ('--exim')
-* OpenLDAP ('--ldap')
-* MariaDB/MySQL ('--mysql')
-* nginx ('--nginx')
-* PostgreSQL ('--pgsql')
-* PHP FPM ('--phpfpm')
+* Apache (``--apache``)
+* Exim Mail (``--exim``)
+* OpenLDAP (``--ldap``)
+* MariaDB/MySQL (``--mysql``)
+* nginx (``--nginx``)
+* PostgreSQL (``--pgsql``)
+* PHP FPM (``--phpfpm``)
 
 .. note:: These optional switches can be combined and that the default behavior of the ``lfphp`` command is to start all services when no options are given.
 
@@ -68,8 +71,8 @@ The available services are :
 
 .. _lfphp-get:
 
-Package Installation Using the 'lfphp-get' Command
---------------------------------------------------
+Package Installation Using the ``lfphp-get`` Command
+----------------------------------------------------
 
 Any *Linux for PHP* container makes it possible to install optional services from within the container by using the
 ``lfphp-get`` command. To install an additional service, simply enter the following command on the container's CLI::
@@ -82,6 +85,6 @@ To get a complete and up to date list of available services, please use the ``--
 
     $ lfphp-get --list
 
-.. note:: For now, *Linux for PHP* does NOT offer an easy way to automate optional services. These must be configured manually by creating and symlinking the appropriate runit scripts ('/services/[name_of_service]' => '/etc/sv/[name_of_service]').
+.. note:: For now, *Linux for PHP* does NOT offer an easy way to automate optional services. These must be configured manually by creating and symlinking the appropriate runit scripts (``/services/[name_of_service]`` => ``/etc/sv/[name_of_service]``).
 
 .. note:: It is possible to get up to date help in using this command by entering the command ``lfphp-get --help`` or ``lfphp-get -h``.
diff --git a/docs/basic_usage.rst b/docs/basic_usage.rst
@@ -14,12 +14,16 @@ Docker's Interactive Mode
 To run a *Linux for PHP* container in interactive mode, with the non thread-safe version of PHP 7.2.12, please
 enter the following command using your system's shell (*Bash*/*PowerShell*)::
 
-    $ docker run --rm -it asclinux/linuxforphp-8.1:7.2.12-nts /bin/bash
+    $ docker run --rm -it asclinux/linuxforphp-8.2-ultimate:7.4-nts /bin/bash
 
 You will then get a command-line interface similar to this one :
 
 .. image:: /images/basic_usage01.png
 
+To find out the IP address assigned (assuming you did not set one manually)::
+
+    $ ifconfig
+
 Once you are done with the container, please quit the container by typing::
 
     $ exit
@@ -38,10 +42,10 @@ Docker's detached mode? To do so, enter the following command::
     -v ${PWD}/:/srv/www \``
     -p 8181:80 \
     -p 10443:443 \
-    asclinux/linuxforphp-8.1:7.2.12-nts \
+    asclinux/linuxforphp-8.2-ultimate:7.4-nts \
     lfphp
 
-.. note:: This last command uses the ``lfphp`` script to start all available services inside the container. For more details, please see :ref:`lfphp-services`
+.. note:: This last command uses the ``lfphp`` script to start all available services inside the container. For more details, please see :ref:`lfphp-services`.
 
 You should now be able to access any of the PHP scripts contained in your project folder by pointing your browser to `<http://localhost:8181/>`_.
 
@@ -55,7 +59,7 @@ Once you are done with the container, you can stop and remove it as you would an
 Pre-Compiled PHP Binaries
 -------------------------
 
-As metioned previously, it is possible to run *Linux for PHP* containers that come with pre-compiled binary versions of
+As mentioned previously, it is possible to run *Linux for PHP* containers that come with pre-compiled binary versions of
 any of the major versions of PHP. To obtain a list of the available binaries, please visit the project's download page:
 
 `<https://linuxforphp.net/download>`_
@@ -74,7 +78,7 @@ version of PHP. Thus, if you prefer to compile and use a different version of PH
 following command in a new terminal window. Please make sure to enter the version that you wish to compile, as per the
 following example (7.4.0dev in this case)::
 
-    $ docker run -dit -p 8181:80 asclinux/linuxforphp-8.1:src /bin/bash -c "lfphp-compile 7.4.0 nts"
+    $ docker run -dit -p 8181:80 asclinux/linuxforphp-8.2:src /bin/bash -c "lfphp-compile 7.4.6 nts"
 
 After a few minutes, the new PHP binaries will be compiled and ready to be used! You can always check on the
 compilation's progress by connecting to the container using the ``docker exec`` command::
@@ -95,62 +99,79 @@ Manually Compiling PHP from Source
 Alternatively, you could also decide to do it manually. If so, start by running a *Linux for PHP* base image containing
 the PHP source files with the following command::
 
-    $ docker run --rm -it asclinux/linuxforphp-8.1:src /bin/bash
+    $ docker run -it asclinux/linuxforphp-8.2-ultimate:src /bin/bash
 
 And, on the container's command line interface (CLI), checkout the version of PHP you wish to compile and begin
-compilation by entering the following commands (in our example, we will compile from master)::
+compilation by entering the following commands (in our example, we will compile PHP 7.4.6)::
 
-    $ cd /root/php-src
-    $ git fetch --all --tags
-    $ git pull origin master
+    $ cd /root
+    $ wget https://github.com/php/php-src/archive/PHP-7.4.6.zip
+    $ unzip PHP-7.4.6.zip
+    $ cd php-src-PHP-7.4.6
     $ ./buildconf --force
-    $ ./configure --prefix=/usr \
-    --sysconfdir=/etc \
-    --localstatedir=/var \
-    --datadir=/usr/share/php \
-    --mandir=/usr/share/man \
-    --enable-fpm \
-    --with-fpm-user=apache \
-    --with-fpm-group=apache \
-    --with-config-file-path=/etc \
-    --with-zlib \
-    --enable-bcmath \
-    --with-bz2 \
-    --enable-calendar \
-    --enable-dba=shared \
-    --with-gdbm \
-    --with-gmp \
-    --enable-ftp \
-    --with-gettext=/usr \
-    --enable-mbstring \
-    --with-readline \
-    --with-mysql-sock=/run/mysqld/mysqld.sock \
-    --with-curl \
-    --with-openssl \
-    --with-openssl-dir=/usr \
-    --with-mhash \
-    --enable-intl \
-    --with-sodium=/usr \
-    --with-libxml-dir=/usr \
-    --with-libdir=/lib64 \
-    --enable-sockets \
-    --enable-libxml \
-    --enable-soap \
-    --with-gd \
-    --with-jpeg-dir=/usr \
-    --with-png-dir=/usr \
-    --with-zlib-dir=/usr \
-    --with-freetype-dir=/usr \
-    --enable-exif \
-    --with-xsl \
-    --with-xmlrpc \
-    --with-pgsql \
-    --with-pdo-mysql=/usr \
-    --with-pdo-pgsql \
-    --with-mysqli \
-    --with-ldap \
-    --with-ldap-sasl \
-    --enable-opcache
+    $ ./configure  \
+        --prefix=/usr   \
+        --sysconfdir=/etc   \
+        --localstatedir=/var   \
+        --datadir=/usr/share/php   \
+        --mandir=/usr/share/man \
+        --enable-fpm   \
+        --with-fpm-user=apache   \
+        --with-fpm-group=apache   \
+        --with-config-file-path=/etc   \
+        --with-zlib \
+        --enable-bcmath   \
+        --with-bz2   \
+        --enable-calendar   \
+        --enable-dba=shared   \
+        --with-gdbm   \
+        --with-gmp   \
+        --enable-ftp \
+        --with-gettext=/usr   \
+        --enable-mbstring   \
+        --enable-pcntl   \
+        --with-pspell   \
+        --with-readline   \
+        --with-snmp \
+        --with-mysql-sock=/run/mysqld/mysqld.sock   \
+        --with-curl   \
+        --with-openssl   \
+        --with-openssl-dir=/usr \
+        --with-mhash   \
+        --enable-intl   \
+        --with-libdir=/lib64   \
+        --enable-sockets   \
+        --with-libxml   \
+        --enable-soap \
+        --enable-gd   \
+        --with-jpeg   \
+        --with-freetype   \
+        --enable-exif   \
+        --with-xsl   \
+        --with-xmlrpc   \
+        --with-pgsql \
+        --with-pdo-mysql=/usr   \
+        --with-pdo-pgsql   \
+        --with-mysqli   \
+        --with-pdo-dblib   \
+        --with-ldap   \
+        --with-ldap-sasl \
+        --enable-shmop   \
+        --enable-sysvsem   \
+        --enable-sysvshm   \
+        --enable-sysvmsg   \
+        --with-tidy   \
+        --with-expat   \
+        --with-enchant \
+        --with-imap=/usr/local/imap-2007f   \
+        --with-imap-ssl=/usr/include/openssl   \
+        --with-kerberos=/usr/include/krb5 \
+        --with-sodium=/usr   \
+        --with-zip   \
+        --enable-opcache   \
+        --with-pear   \
+        --with-ffi   \
+        --enable-opcache
     $ make
     $ make test
     $ make install
diff --git a/docs/conf.py b/docs/conf.py
@@ -45,16 +45,16 @@
 
 # General information about the project.
 project = 'Linux for PHP'
-copyright = '2018, Foreach Code Factory'
+copyright = '2020, Foreach Code Factory'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '8.1'
+version = '8.2'
 # The full version, including alpha/beta/rc tags.
-release = '8.1.3'
+release = '8.2.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/docs/cookbook.rst b/docs/cookbook.rst
@@ -8,8 +8,8 @@ or to debug/profile a slow PHP script you are working on in development.
 
 .. index:: CMS installation
 
-CMS Installation Using the 'lfphp-get' Command
-----------------------------------------------
+CMS Installation Using the ``lfphp-get`` Command
+------------------------------------------------
 
 To install *Concrete5*, *Drupal*, *Joomla* or *WordPress* inside a Linux for PHP container, please enter the following command
 on the container's CLI::
@@ -21,14 +21,14 @@ you will be able to finish installing *Concrete5*, *Drupal*, *Joomla* or *WordPr
 Web installer. By default, the CMS will be installed in the ``/srv/tempo`` folder inside the container. If you share this folder
 with the host, you will be able to access the source from outside the container after the end of the CMS' installation.
 
-.. note:: If you are using clean URLs, you might have to create the appropriate HTACCESS file according to what is needed to run the CMS that you are installing.
+.. note:: If you are using clean URLs, you might have to create the appropriate .htaccess file according to what is needed to run the CMS that you are installing.
 
 .. index:: Framework installation
 
 .. index:: PHP framework installation
 
-PHP Framework Installation Using the 'lfphp-get' Command
---------------------------------------------------------
+PHP Framework Installation Using the ``lfphp-get`` Command
+----------------------------------------------------------
 
 To install *Zend Framework*, *Zend Expressive*, *Symfony*, *Laravel*, *CakePHP*, *Slim* or *LightMVC* inside a Linux for PHP container, please enter the following command
 on the container's CLI::
@@ -41,8 +41,8 @@ After asking which framework is to be installed and what is the project's name,
 
 .. index:: Blackfire.io installation
 
-Blackfire.io Installation Using the 'lfphp-get' Command
--------------------------------------------------------
+Blackfire.io Installation Using the ``lfphp-get`` Command
+---------------------------------------------------------
 
 If you wish to install and configure *Blackfire.io* on *Linux for PHP*, please run this command::
 
@@ -53,8 +53,8 @@ or by installing and using the *Blackfire* browser plugin in your favorite brows
 
 .. index:: Node.js installation
 
-Node.js Installation Using the 'lfphp-get' Command
---------------------------------------------------
+Node.js Installation Using the ``lfphp-get`` Command
+----------------------------------------------------
 
 If you wish to install and configure *Node.js* on *Linux for PHP*, please run this command on the container's CLI::
 
diff --git a/docs/images/basic_usage01.png b/docs/images/basic_usage01.png
diff --git a/docs/whats_new.rst b/docs/whats_new.rst
