编辑“︁PHP命令行模式”︁（章节）

= PHP命令行模式 =

PHP命令行模式（CLI，Command-Line Interface）是PHP的一种运行方式，允许开发者在终端或命令行界面中直接执行PHP脚本，而无需通过Web服务器（如Apache或Nginx）。这种模式特别适合编写系统管理脚本、自动化任务、数据处理工具等。

== 介绍 ==

PHP CLI模式与传统的Web模式不同，它不依赖于HTTP请求和响应，而是直接在终端中运行。PHP CLI模式具有以下特点：

* **独立运行**：不需要Web服务器。
* **无超时限制**：脚本可以长时间运行（除非手动终止）。
* **直接输入输出**：通过标准输入（stdin）和标准输出（stdout）交互。
* **适用于后台任务**：可用于定时任务（如Cron Job）或批处理脚本。

== 如何运行PHP CLI脚本 ==

要运行PHP CLI脚本，只需在终端中输入以下命令：
<syntaxhighlight lang="bash">
php /path/to/your/script.php
</syntaxhighlight>

如果PHP已正确安装并加入系统环境变量，可以直接调用`php`命令。如果未配置环境变量，可能需要使用完整路径（如`/usr/bin/php`）。

=== 检查PHP CLI是否可用 ===
运行以下命令检查PHP CLI是否安装：
<syntaxhighlight lang="bash">
php -v
</syntaxhighlight>
如果显示PHP版本信息，则说明CLI模式可用。

== 基本示例 ==

以下是一个简单的PHP CLI脚本示例，演示如何在命令行中输出内容：
<syntaxhighlight lang="php">
<?php
echo "Hello, PHP CLI Mode!\n";
?>
</syntaxhighlight>

保存为`hello.php`并运行：
<syntaxhighlight lang="bash">
php hello.php
</syntaxhighlight>
输出：
<pre>
Hello, PHP CLI Mode!
</pre>

=== 接受命令行参数 ===
PHP CLI脚本可以通过`$argv`数组获取命令行参数，`$argc`表示参数数量。

<syntaxhighlight lang="php">
<?php
if ($argc < 2) {
    echo "Usage: php script.php <name>\n";
    exit(1);
}
echo "Hello, " . $argv[1] . "!\n";
?>
</syntaxhighlight>

运行：
<syntaxhighlight lang="bash">
php script.php Alice
</syntaxhighlight>
输出：
<pre>
Hello, Alice!
</pre>

== 实际应用案例 ==

PHP CLI模式在以下场景中非常有用：

=== 1. 批处理数据处理 ===
假设需要处理一个CSV文件并生成报告：
<syntaxhighlight lang="php">
<?php
if ($argc != 2) {
    echo "Usage: php process_csv.php <file.csv>\n";
    exit(1);
}

$file = $argv[1];
if (!file_exists($file)) {
    echo "Error: File not found.\n";
    exit(1);
}

$handle = fopen($file, 'r');
while (($data = fgetcsv($handle)) !== false) {
    print_r($data);
}
fclose($handle);
?>
</syntaxhighlight>

=== 2. 定时任务（Cron Job） ===
在Linux系统中，可以使用Cron定时运行PHP脚本：
<syntaxhighlight lang="bash">
# 每天凌晨执行脚本
0 0 * * * /usr/bin/php /path/to/your/script.php
</syntaxhighlight>

=== 3. 构建命令行工具 ===
PHP CLI可用于构建自定义命令行工具，例如：
<syntaxhighlight lang="php">
<?php
$shortopts = "u:p:";
$longopts = ["user:", "password:"];
$options = getopt($shortopts, $longopts);

if (empty($options['u']) || empty($options['p'])) {
    echo "Usage: php tool.php -u <user> -p <password>\n";
    exit(1);
}

echo "Authenticating as " . $options['u'] . "...\n";
// 执行认证逻辑
?>
</syntaxhighlight>

== 高级用法 ==

=== 交互式输入 ===
使用`fgets(STDIN)`读取用户输入：
<syntaxhighlight lang="php">
<?php
echo "What is your name? ";
$name = trim(fgets(STDIN));
echo "Hello, $name!\n";
?>
</syntaxhighlight>

运行：
<syntaxhighlight lang="bash">
php interactive.php
</syntaxhighlight>
输出：
<pre>
What is your name? Bob
Hello, Bob!
</pre>

=== 进程控制 ===
PHP CLI支持多进程和信号处理：
<syntaxhighlight lang="php">
<?php
pcntl_signal(SIGINT, function () {
    echo "Received SIGINT. Exiting...\n";
    exit(0);
});

echo "Running. Press Ctrl+C to stop.\n";
while (true) {
    sleep(1);
}
?>
</syntaxhighlight>

== 性能优化 ==

PHP CLI脚本可以通过以下方式优化：
* 使用`opcache.enable_cli=1`启用OPcache。
* 避免不必要的内存泄漏。
* 使用`gc_collect_cycles()`手动触发垃圾回收。

== 总结 ==

PHP CLI模式是一个强大的工具，适用于：
* 系统管理脚本
* 数据处理任务
* 自动化工具开发
* 定时任务执行

通过命令行参数、标准输入输出和进程控制，PHP CLI可以满足各种复杂需求。

<mermaid>
graph LR
    A[PHP CLI脚本] --> B[终端运行]
    B --> C[数据处理]
    B --> D[系统管理]
    B --> E[自动化任务]
</mermaid>

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP基础]]