php_sapi_name() 回傳 PHP 與 Web 伺服器互動的介面類型(SAPI:Server API),是判斷執行環境的標準方式。
| 執行環境 | php_sapi_name() 回傳值 | 備註 |
|---|---|---|
| Apache 模組模式 | apache2handler | 最常見的生產環境 |
| Nginx + PHP-FPM | fpm-fcgi | 現代主流部署架構 |
| CGI / FastCGI | cgi-fcgi | 傳統共享主機環境 |
| 命令列模式 (CLI) | cli | 腳本、排程任務、Artisan 等 |
| 內建開發伺服器 | cli-server | PHP 5.4+ php -S |
| Apache CGI | cgi | 較少見 |
| IIS (ISAPI/FastCGI) | isapi / cgi-fcgi | Windows 環境 |
<?php
if (php_sapi_name() === 'cli') {
// 命令列模式:啟用詳細日誌、關閉輸出緩衝
ini_set('display_errors', 1);
error_reporting(E_ALL);
} else {
// Web 模式:正常錯誤處理、啟用 Session
session_start();
}
?>
<?php
$sapi = php_sapi_name();
$config = [
'cli' => [
'memory_limit' => '512M',
'max_execution_time' => 0,
'log_path' => '/var/log/cli/',
],
'fpm-fcgi' => [
'memory_limit' => '256M',
'max_execution_time' => 30,
'log_path' => '/var/log/fpm/',
],
'apache2handler' => [
'memory_limit' => '128M',
'max_execution_time' => 30,
'log_path' => '/var/log/apache/',
],
];
$envConfig = $config[$sapi] ?? $config['fpm-fcgi'];
foreach ($envConfig as $key => $value) {
ini_set($key, $value);
}
?>
<?php
// 僅允許 CLI 執行的維護腳本
if (php_sapi_name() !== 'cli') {
http_response_code(403);
die('Forbidden: CLI only script');
}
// 執行資料庫遷移、清理快取等敏感操作
?>
<?php
echo "SAPI: " . php_sapi_name() . "\n";
echo "OS: " . PHP_OS . "\n"; // Linux, Darwin, WINNT 等
echo "PHP 版本: " . PHP_VERSION . "\n";
// 完整環境資訊
$info = [
'sapi' => php_sapi_name(),
'os' => PHP_OS,
'php_version' => PHP_VERSION,
'zend_version' => zend_version(),
'is_cli' => (php_sapi_name() === 'cli'),
'is_web' => (php_sapi_name() !== 'cli'),
];
print_r($info);
?>
cgi-fcgi 或 fpm-fcgiPHP_SAPI 常數與 php_sapi_name() 回傳值相同,效能略優