jtreminio/php-cli

jtreminio/php-cli 镜像文档

支持的标签

• jtreminio/php-cli:8.1
• jtreminio/php-cli:8.0
• jtreminio/php-cli:7.4

https://hub.docker.com/r/jtreminio/php-cli/tags/

https://github.com/jtreminio/php-docker/blob/master/Dockerfile-php-cli

如何使用此镜像

命令行使用

对于通过命令行界面(CLI)运行的PHP项目，可按以下方式操作。

在PHP项目中创建Dockerfile

dockerfile
FROM jtreminio/php-cli:8.1
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
CMD [ "php", "./your-script.php" ]

然后运行以下命令构建并运行Docker镜像：

shell
docker build -t my-php-app .
docker run -it --rm --name my-running-app my-php-app

运行单个PHP脚本

对于许多简单的单文件项目，编写完整的Dockerfile可能不方便。这种情况下，可以直接使用PHP Docker镜像运行PHP脚本：

shell
docker run -it --rm \
    --name my-running-script \
    -v "$PWD":/usr/src/myapp \
    -w /usr/src/myapp \
    jtreminio/php-cli:8.1 php your-script.php

注意：所有PHP镜像变体均包含PHP CLI。

与PHP-FPM一起使用

我已创建包含PHP-FPM的镜像。

https://hub.docker.com/r/jtreminio/php

与Nginx或Apache一起使用

我已创建这些镜像的全功能Nginx/Apache版本。

https://hub.docker.com/r/jtreminio/php-nginx

https://hub.docker.com/r/jtreminio/php-apache

关于这些镜像

这些镜像基于Ondřej Surý的PPA构建。

它们内置了最常用的PHP模块。完整列表如下。

Composer安装在/usr/local/bin/composer。

PHP-CLI INI文件在所有版本中均保存在标准位置，以便简化管理。

• CLI使用的PHP INI位于/etc/php/cli.ini

提供了两个空白INI文件，供您编写自定义INI设置：

• /etc/php/cli-custom.ini
• /etc/php/php-custom.ini

使用-v your-file.ini:/etc/php/cli-custom.ini添加您的设置。这两个文件最后加载，因此其内容将优先于其他所有设置。

通过环境变量配置INI

您可以使用环境变量设置大量PHP INI配置。

https://github.com/jtreminio/php-docker/blob/master/Dockerfile-env

您可以在此处了解更多详细信息

shell
docker container run -it --rm \
    jtreminio/php-cli:8.1 php -i | grep display_errors

100:display_errors => Off => Off

对比

shell
docker container run -it --rm \
    -e PHP.display_errors=1 \
    jtreminio/php-cli:8.1 php -i | grep display_errors

100:display_errors => STDOUT => STDOUT

已安装的模块

许多模块默认已安装并启用：

• php-bcmath
• php-cli
• php-curl
• php-intl
• php-json
• php-mbstring
• php-mysql
• php-opcache
• php-xml
• php-zip

更多模块已安装但默认未启用：

• php-amqp
• php-apcu
• php-gd
• php-igbinary
• php-imagick
• php-mailparse
• php-memcached
• php-mongodb
• php-oauth
• php-raphf
• php-redis
• php-soap
• php-solr
• php-sqlite3
• php-uuid
• php-zmq
• php-xdebug

PHP 7.4还包含：

• apcu_bc
• geoip
• gnupg
• radius
• ssh2
• stomp
• uploadprogress

您可以使用PHP_INI_SCAN_DIR环境变量启用这些模块。已创建特殊快捷方式以便更轻松地添加模块：

shell
docker container run -it --rm \
    -e PHP_INI_SCAN_DIR=:/p/amqp:/p/mailparse \
    jtreminio/php-cli:8.1 php -v

/p目录包含指向其他目录的符号链接（如果PHP版本支持该模块）：

/p/amqp            -> /etc/php/extra-mods/amqp
/p/apcu            -> /etc/php/extra-mods/apcu
/p/geoip           -> /etc/php/extra-mods/geoip
/p/gnupg           -> /etc/php/extra-mods/gnupg
/p/imagick         -> /etc/php/extra-mods/imagick
/p/lua             -> /etc/php/extra-mods/lua
/p/mailparse       -> /etc/php/extra-mods/mailparse
/p/memcached       -> /etc/php/extra-mods/memcached
/p/mongodb         -> /etc/php/extra-mods/mongodb
/p/oauth           -> /etc/php/extra-mods/oauth
/p/pdo_sqlite      -> /etc/php/extra-mods/pdo_sqlite
/p/radius          -> /etc/php/extra-mods/radius
/p/raphf           -> /etc/php/extra-mods/raphf
/p/redis           -> /etc/php/extra-mods/redis
/p/solr            -> /etc/php/extra-mods/solr
/p/sqlite3         -> /etc/php/extra-mods/sqlite3
/p/ssh2            -> /etc/php/extra-mods/ssh2
/p/stomp           -> /etc/php/extra-mods/stomp
/p/uploadprogress  -> /etc/php/extra-mods/uploadprogress
/p/uuid            -> /etc/php/extra-mods/uuid
/p/xdebug          -> /etc/php/extra-mods/xdebug
/p/zmq             -> /etc/php/extra-mods/zmq

您可以在PHP_INI_SCAN_DIR中添加任意数量的这些路径，确保以:开头。

您可以通过访问通过环境变量切换PHP模块了解更多详细信息。

Xdebug

Xdebug默认已安装但未启用：

shell
docker container run -it --rm jtreminio/php-cli:8.1 php -v

PHP 8.1.2 (cli) (built: Jan 24 2022 10:42:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.2, Copyright (c), by Zend Technologies

要启用Xdebug（仅在非公共服务器上！），您可以使用PHP_INI_SCAN_DIR环境变量：

shell
docker container run -it --rm \
    -e PHP_INI_SCAN_DIR=:/p/xdebug \
    jtreminio/php-cli:8.1 php -v

PHP 8.1.2 (cli) (built: Jan 24 2022 10:42:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.2, Copyright (c), by Zend Technologies
    with Xdebug v3.1.2, Copyright (c) 2002-2021, by Derick Rethans

注意:/p/xdebug中的前置:。

xdebug.remote_host默认设置为host.docker.internal。https://github.com/docker/for-linux/issues/264%E3%80%82%E6%82%A8%E5%BF%85%E9%A1%BB%E7%9B%B4%E6%8E%A5%E4%BC%A0%E9%80%92%E4%B8%BB%E6%9C%BAIP%E6%88%96%E4%BD%BF%E7%94%A8%E7%BD%91%E5%85%B3%E3%80%82%E5%A4%A7%E5%A4%9A%E6%95%B0%E6%83%85%E5%86%B5%E4%B8%8B%EF%BC%8C%60172.17.0.1%60%E5%8F%AF%E4%BB%A5%E6%AD%A3%E5%B8%B8%E5%B7%A5%E4%BD%9C%EF%BC%9A

shell
docker container run -it --rm \
    -e PHP_INI_SCAN_DIR=:/p/xdebug \
    -e PHP.xdebug.client_host=172.17.0.1 \
    jtreminio/php-cli:8.1 php -i | grep xdebug.client_host

639:xdebug.client_host => 172.17.0.1 => 172.17.0.1

已创建/usr/bin/xdebug辅助脚本，帮助您调试CLI应用程序。

要使用它，直接调用它而不是php：

shell
docker container run -it --rm \
    jtreminio/php-cli:8.1 xdebug -v

PHP 8.1.2 (cli) (built: Jan 24 2022 10:42:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.2, Copyright (c), by Zend Technologies
    with Xdebug v3.1.2, Copyright (c) 2002-2021, by Derick Rethans