Ubuntu 26.04 PHP CLI の基本設定 – コマンドラインで PHP を使う

Ubuntu 26.04 で PHP を使う場合、Web サーバーから実行される PHP-FPM と、コマンドラインから実行する PHP CLI を分けて考える必要があります。Web アプリケーションの実行、管理コマンド、cron、Composer、Nextcloud の occ などでは、同じ PHP でも使われ方が異なります。

この記事では、Ubuntu 26.04 で PHP CLI を使うための基本を整理します。PHP パッケージ、拡張 module、php.ini、phpenmod、PHP-FPM との違いを確認し、CLI 実行環境として破綻しにくい形を作ることを目的にします。

PHP CLI と PHP-FPM は役割が違う

PHP-FPM は Web サーバーから FastCGI 経由で PHP を実行するための仕組みです。一方、PHP CLI は shell、cron、systemd、管理コマンドから PHP を直接実行するためのものです。どちらも PHP ですが、設定ファイル、実行ユーザー、環境変数、タイムアウト、メモリ制限の効き方が変わります。

現在の PHP を確認する

まず、PHP CLI が入っているか、どのバージョンが使われているか、どの設定ファイルを読んでいるかを確認します。

php -v
which php
php --ini
php -m

php --ini では、CLI が読み込んでいる php.ini と追加 ini ファイルを確認できます。FPM 側の設定を見ているつもりで CLI の設定を変えていた、またはその逆、という混乱を避けるために最初に確認しておきます。

PHP と拡張 module をインストールする

PHP CLI だけでなく、実際のサーバー運用では拡張 module も必要になります。Nextcloud、WordPress、管理スクリプト、DB 接続、Redis、画像処理などを考えると、PHP 本体だけでは足りないことが多いです。

sudo apt update
sudo apt install -y php php-apcu php-bcmath php-bz2 php-cgi php-curl php-enchant php-gd php-gmp php-imagick php-intl php-ldap php-mbstring php-mysql php-pear php-redis php-smbclient php-xml php-zip imagemagick

必要な拡張は用途によって変わります。大事なのは、アプリケーションが要求する PHP module と、CLI で実行する管理コマンドが要求する PHP module を分けずに確認することです。Web では動くのに CLI の管理コマンドだけ失敗する場合、CLI 側で module が読み込まれていないことがあります。

PHP module の読み込みを確認する

拡張 module を導入したら、php -m で CLI から見えているか確認します。Redis、LDAP、MySQL、mbstring、xml などは、アプリケーション管理コマンドでも必要になることがあります。

php -m | grep -E 'apcu|curl|gd|intl|ldap|mbstring|mysqli|redis|smbclient|xml|zip'
php -i | grep '^Loaded Configuration File'
php -i | grep '^Scan this dir for additional .ini files'

CLI 用の追加 ini を配置する

サーバーごとの PHP 設定をまとめたい場合、mods-available に追加 ini を配置し、phpenmod で有効化する方法があります。たとえば、my.php.ini のようなファイルを作り、タイムゾーン、アップロードサイズ、メモリ制限、APCu、OPcache、Redis session などをまとめます。

sudo tee /etc/php/8.5/mods-available/my.php.ini >/dev/null <<'EOF'
date.timezone = "Asia/Tokyo"
post_max_size = 10G
upload_max_filesize = 10G
memory_limit = 1G
max_input_time = 3600
max_execution_time = 3600
max_input_vars = 2000
apc.enable_cli = 1
opcache.enable = 1
opcache.memory_consumption = 256
opcache.interned_strings_buffer = 32
opcache.max_accelerated_files = 20000
opcache.revalidate_freq = 1
opcache.save_comments = 1
output_buffering = Off
EOF
sudo phpenmod -v 8.5 my.php

PHP のバージョンは環境に合わせます。Ubuntu 26.04 の標準や追加リポジトリの状況によって、実際のディレクトリは /etc/php/8.4 や /etc/php/8.5 などになります。必ず php -v と php --ini で実環境を確認してから指定します。

CLI と FPM の設定差を確認する

PHP CLI と PHP-FPM は、同じ module を使っていても読み込む設定ファイルの場所が異なります。CLI 側だけを確認して Web 側が動かない、または Web 側だけを確認して cron や管理コマンドが失敗する、という状態を避けるため、両方を確認します。

php --ini
php -i | grep '^memory_limit'
php -i | grep '^date.timezone'
systemctl status php8.5-fpm.service

FPM 側は pool 設定、socket、実行ユーザー、service 状態も関係します。この記事では CLI を主語にしていますが、Web アプリケーションを運用する場合は PHP-FPM の記事と合わせて確認する必要があります。

Composer や管理コマンドで使う時の注意

Composer、Nextcloud の occ、WordPress の WP-CLI のようなツールは、PHP CLI を前提に動きます。このとき、実行ユーザー、カレントディレクトリ、環境変数、読み込む PHP module が重要になります。

まとめ

Ubuntu 26.04 で PHP を使う場合、PHP CLI と PHP-FPM を同じものとして扱うとトラブルになります。CLI は管理コマンド、cron、Composer、アプリケーションのメンテナンス処理で使われ、FPM は Web リクエスト処理で使われます。

PHP 本体と拡張 module を導入したうえで、php -v、php --ini、php -m を確認し、追加 ini をどこに置き、どの PHP バージョンで有効化するのかを明確にしておくことが重要です。CLI と FPM の責務を分けておくと、Web アプリケーション運用時の切り分けがかなり楽になります。

次に読む記事

関連記事

Ubuntu 22.04 Apache PHP 有効化 – libapache2-mod-php の設定と確認 Ubuntu 26.04 PHP-FPM の基本設定 – Web サーバーから PHP を実行する Ubuntu 22.04 KVM virt-install – 仮想マシンを CLI でデプロイする Ubuntu 22.04 ホスト名の設定 – hostnamectl と /etc/hosts を使う Ubuntu 22.04 Apache HTTP/2 有効化 – TLS VirtualHost で h2 を使う Ubuntu 22.04 Vue.js 開発環境 – npm / Vue CLI / Vite の位置づけを整理する Ubuntu 26.04 KVM VM テンプレートの作成 – autoinstall と qcow2 を使う Ubuntu 26.04 Cockpit の基本設定 – Linux サーバーを Web UI で確認する