yan/docker-php-nginx
1
0
Fork 0
mirror of https://github.com/netfun2000/docker-php-nginx.git synced 2026-04-21 16:18:59 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation and examples

Browse Source
This commit is contained in:
Tim de Pater
2023-08-27 11:55:30 +02:00
parent 7fb96f7ee7
commit 9cda0d06f4
4 changed files with 91 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@@ -39,12 +39,6 @@ Or mount your own code to be served by PHP-FPM & Nginx
docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx
### Docker Hub repository name change
Since we switched to PHP8 the repository name [trafex/alpine-nginx-php7](https://hub.docker.com/r/trafex/alpine-nginx-php7) didn't make sense anymore.
Because you can't change the name of the repository on Docker Hub I created a new one.
From now on this image can be pulled from Docker Hub under the name [trafex/php-nginx](https://hub.docker.com/r/trafex/php-nginx).
## Configuration
In [config/](config/) you'll find the default configuration files for Nginx, PHP and PHP-FPM.
If you want to extend or customize that you can do so by mounting a configuration file in the correct folder;
@@ -59,44 +53,13 @@ PHP configuration:
PHP-FPM configuration:
docker run -v "`pwd`/php-fpm-settings.conf:/etc/php8/php-fpm.d/server.conf" trafex/php-nginx
docker run -v "`pwd`/php-fpm-settings.conf:/etc/php82/php-fpm.d/server.conf" trafex/php-nginx
_Note; Because `-v` requires an absolute path I've added `pwd` in the example to return the absolute path to the current directory_
## Documentation and examples
To modify this container to your specific needs please see the following examples;
## Adding composer
If you need [Composer](https://getcomposer.org/) in your project, here's an easy way to add it.
```Dockerfile
FROM trafex/php-nginx:latest
# Install composer from the official image
COPY --from=composer /usr/bin/composer /usr/bin/composer
# Run composer install to install the dependencies
RUN composer install --optimize-autoloader --no-interaction --no-progress
```
### Building with composer
If you are building an image with source code in it and dependencies managed by composer then the definition can be improved.
The dependencies should be retrieved by the composer but the composer itself (`/usr/bin/composer`) is not necessary to be included in the image.
```Dockerfile
FROM composer AS composer
# copying the source directory and install the dependencies with composer
COPY <your_directory>/ /app
# run composer install to install the dependencies
RUN composer install \
--optimize-autoloader \
--no-interaction \
--no-progress
# continue stage build with the desired image and copy the source including the
# dependencies downloaded by composer
FROM trafex/php-nginx
COPY --chown=nginx --from=composer /app /var/www/html
```
* [Adding xdebug support](docs/xdebug-support.md)
* [Adding composer](docs/composer-support.md)
* [Getting the real IP of the client behind a load balancer](docs/real-ip-behind-loadbalancer.md)

35
docs/composer-support.md Normal file
View File

@@ -0,0 +1,35 @@
# Adding composer
If you need [Composer](https://getcomposer.org/) in your project, here's an easy way to add it.
```Dockerfile
FROM trafex/php-nginx:latest
# Install composer from the official image
COPY --from=composer /usr/bin/composer /usr/bin/composer
# Run composer install to install the dependencies
RUN composer install --optimize-autoloader --no-interaction --no-progress
```
## Building with composer
If you are building an image with source code in it and dependencies managed by composer then the definition can be improved.
The dependencies should be retrieved by the composer but the composer itself (`/usr/bin/composer`) is not necessary to be included in the image.
```Dockerfile
FROM composer AS composer
# Copying the source directory and install the dependencies with composer
COPY <your_directory>/ /app
# Run composer install to install the dependencies
RUN composer install \
--optimize-autoloader \
--no-interaction \
--no-progress
# Continue stage build with the desired image and copy the source including the dependencies downloaded by composer
FROM trafex/php-nginx:latest
COPY --chown=nginx --from=composer /app /var/www/html
```

13
docs/real-ip-behind-loadbalancer.md Normal file
View File

@@ -0,0 +1,13 @@
# Getting the real IP of the client behind a load balancer
If you use this container behind a proxy or load balancer you might want to get the real IP of the client instead of the IP of the proxy or load balancer.
To do this you can add the following configuration to the [Nginx configuration](../config/nginx.conf):
```nginx
set_real_ip_from <CIDR>
real_ip_header X-Forwarded-For;
real_ip_recursive on;
```
Where `<CIDR>` is the CIDR of your proxy or load balancer, see the [Nginx documentation](http://nginx.org/en/docs/http/ngx_http_realip_module.html#set_real_ip_from). The real IP of the client will now be available in PHP under `$_SERVER['REMOTE_ADDR']`.

37
docs/xdebug-support.md Normal file
View File

@@ -0,0 +1,37 @@
# Adding xdebug support
Create the following file `xdebug.ini`
```ini
zend_extension=xdebug.so
xdebug.mode=develop,debug
xdebug.discover_client_host=true
xdebug.start_with_request=yes
xdebug.trigger_value=PHPSTORM
xdebug.log_level=0
xdebug.var_display_max_children=10
xdebug.var_display_max_data=10
xdebug.var_display_max_depth=10
xdebug.client_host=host.docker.internal
xdebug.client_port=9003
```
Create a new image with the following `Dockerfile`
```Dockerfile
FROM trafex/php-nginx:latest
# Temporary switch to root
USER root
# Install xdebug
RUN apk add --no-cache php82-pecl-xdebug
# Add configuration
COPY xdebug.ini ${PHP_INI_DIR}/conf.d/xdebug.ini
# Switch back to non-root user
USER nobody
```