Skip to content

Commit f45cdd1

Browse files
committed
2021-06-16 AC: Updates the documentation.
1 parent 9ff9e54 commit f45cdd1

File tree

5 files changed

+14
-52
lines changed

5 files changed

+14
-52
lines changed

docs/advanced_features.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ Any *Linux for PHP* container makes it possible to install optional services fro
7979

8080
$ lfphp-get [options] name_of_service_to_install
8181

82-
.. note:: The ``lfphp-get`` command allows to compile some packages from source, by adding the ``--compile`` option at the end of the command.
82+
.. note:: The ``lfphp-get`` command allows to compile some packages from source, by adding the ``--compile`` option to the command.
8383

8484
To get a complete and up to date list of available services, please use the ``--list`` option::
8585

docs/basic_usage.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Docker's interactive or detached modes.
1111
Docker's Interactive Mode
1212
-------------------------
1313

14-
To run a *Linux for PHP* container in interactive mode, with the non thread-safe version of PHP 7.2.12, please
14+
To run a *Linux for PHP* container in interactive mode, with the non thread-safe version of PHP 7.4, please
1515
enter the following command using your system's shell (*Bash*/*PowerShell*)::
1616

1717
$ docker run --rm -it asclinux/linuxforphp-8.2-ultimate:7.4-nts /bin/bash
@@ -76,9 +76,9 @@ Compiling PHP from Source
7676
Of course, *Linux for PHP* is a lightweight version of Linux with all the software needed to easily compile any recent
7777
version of PHP. Thus, if you prefer to compile and use a different version of PHP, you can do so by entering the
7878
following command in a new terminal window. Please make sure to enter the version that you wish to compile, as per the
79-
following example (7.4.0dev in this case)::
79+
following example (8.1.0dev in this case)::
8080

81-
$ docker run -dit -p 8181:80 asclinux/linuxforphp-8.2:src /bin/bash -c "lfphp-compile 7.4.6 nts"
81+
$ docker run -dit -p 8181:80 asclinux/linuxforphp-8.2:src /bin/bash -c "lfphp-compile 8.1.0 nts"
8282

8383
After a few minutes, the new PHP binaries will be compiled and ready to be used! You can always check on the
8484
compilation's progress by connecting to the container using the ``docker exec`` command::

docs/cookbook.rst

Lines changed: 7 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ or to debug/profile a slow PHP script you are working on in development.
1111
CMS Installation Using the ``lfphp-get`` Command
1212
------------------------------------------------
1313

14-
To install *Concrete5*, *Drupal*, *Joomla* or *WordPress* inside a Linux for PHP container, please enter the following command
14+
To install *Concrete5*, *Drupal*, *Joomla*, *WordPress*, *Magento* or *Prestashop* inside a Linux for PHP container, please enter the following command
1515
on the container's CLI::
1616

1717
$ lfphp-get cms
1818

19-
After asking which CMS is to be installed and what is the project's name, the ``lfphp-get`` command will set everything up for you. Once it is done,
20-
you will be able to finish installing *Concrete5*, *Drupal*, *Joomla* or *WordPress* by using the corresponding CMS' default
19+
After asking you which CMS you wish to install, and what is your project's name, the ``lfphp-get`` command will set everything up for you. Once this is done,
20+
you will be able to finish installing *Concrete5*, *Drupal*, *Joomla*, *WordPress*, *Magento* or *Prestashop* by using the corresponding CMS' default
2121
Web installer. By default, the CMS will be installed in the ``/srv/tempo`` folder inside the container. If you share this folder
2222
with the host, you will be able to access the source from outside the container after the end of the CMS' installation.
2323

@@ -30,12 +30,12 @@ with the host, you will be able to access the source from outside the container
3030
PHP Framework Installation Using the ``lfphp-get`` Command
3131
----------------------------------------------------------
3232

33-
To install *Zend Framework*, *Zend Expressive*, *Symfony*, *Laravel*, *CakePHP*, *Slim* or *LightMVC* inside a Linux for PHP container, please enter the following command
33+
To install *Laminas (Zend Framework)*, *Mezzio (Zend Expressive)*, *Symfony*, *Laravel*, *CakePHP*, *Slim* or *LightMVC* inside a Linux for PHP container, please enter the following command
3434
on the container's CLI::
3535

3636
$ lfphp-get php-frameworks
3737

38-
After asking which framework is to be installed and what is the project's name, the ``lfphp-get`` command will set everything up for you.
38+
After asking you which framework you want to install, and what is your project's name, the ``lfphp-get`` command will set everything up for you.
3939

4040
.. note:: By default, the framework's skeleton application 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 code from outside the container after the end of the framework's installation.
4141

@@ -48,7 +48,7 @@ If you wish to install and configure *Blackfire.io* on *Linux for PHP*, please r
4848

4949
$ lfphp-get blackfire
5050

51-
Once done, you will be able to profile your PHP applications by using the *Blackfire* command line tool we installed previously
51+
Once done, you will be able to profile your PHP applications by using the *Blackfire* command line tool directly,
5252
or by installing and using the *Blackfire* browser plugin in your favorite browser.
5353

5454
.. index:: Node.js installation
@@ -79,49 +79,11 @@ Once done, *MongoDB* and its import and export tools will be available from with
7979

8080
If you wish to use the *MongoDB* extension for PHP, you can do so by entering the following commands on the container's CLI::
8181

82-
$ pecl install mongodb
82+
$ lfphp-get --force php-ext mongodb
8383
$ echo "extension=mongodb.so" >> /etc/php.ini
8484

8585
.. note:: It is possible to compile *MongoDB* from source by adding the ``--compile`` option to the ``lfphp-get`` command.
8686

8787
For more information on the ``lfphp-get`` command, please see :ref:`lfphp-get`.
8888

8989
.. note:: Also, it is possible to use *MongoDB* with all of its SSL options by default.
90-
91-
.. index:: Production - settings and configuration
92-
93-
Configuring PHP with Production Settings
94-
----------------------------------------
95-
96-
.. note:: ATTENTION! This code example does NOT cover security issues and how to harden your server installation!
97-
98-
In order to configure *Linux for PHP* with the most common production settings and extensions, please run an *Linux for PHP* base image
99-
with the PHP source code (asclinux/linuxforphp-8.1:src) with the following command::
100-
101-
$ docker run -dit -p 8181:80 asclinux/linuxforphp-8.1:src /bin/bash -c "lfphp-compile 7.2.12 nts"
102-
103-
Once done, you will be able to run any PHP script from the CLI or the Web server with the most common production settings.
104-
105-
For more information on the ``lfphp-compile`` command, please see :ref:`lfphp-compile`.
106-
107-
.. index:: Multithreading
108-
109-
.. index:: Thread-safety
110-
111-
.. index:: PHP Extensions - pthreads
112-
113-
.. index:: Posix Threads (pthreads)
114-
115-
Running Multithreaded PHP Scripts
116-
---------------------------------
117-
118-
In order to run a multithreaded PHP script inside a *Linux for PHP* container, please enter the following command::
119-
120-
$ docker run --rm -it asclinux/linuxforphp-8.1:7.0.29-zts /bin/bash
121-
122-
Then, on the container's CLI, please enter these commands::
123-
124-
$ pecl install pthreads
125-
$ echo "extension=pthreads.so" >> /etc/php.ini
126-
127-
After restarting PHP-FPM (if necessary), you will be able to run multithreaded PHP scripts on your computer.

docs/index.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,12 @@ Welcome to Linux for PHP's Documentation
99
.. toctree::
1010
:maxdepth: 3
1111

12-
license
13-
whats_new
1412
installation
1513
basic_usage
1614
advanced_features
1715
cookbook
16+
whats_new
17+
license
1818

1919

2020
Indices and tables

docs/whats_new.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ What's New in Version 8.2
44
===========================
55

66
New Since Version 8.2.0 (May 17, 2020)
7-
-------------------------------------
7+
--------------------------------------
88

99
* New features:
1010
- PHP has been updated to version 7.4.6

0 commit comments

Comments
 (0)