PHP 怎么CLI游戏

用PHP打造你的第一个CLI游戏（交互式命令行实战指南）

📚 目录导读

• 为什么选择PHP做CLI游戏？ —— 打破Web开发定式，挖掘PHP的隐藏潜力
• 环境准备与核心概念 —— STDIN/STDOUT、终端控制与脚本执行机制
• 实战项目：猜数字游戏 —— 完整代码拆解，从输入逻辑到循环判断
• 进阶：打造「贪吃蛇」的简化版 —— 使用ncurses扩展实现键盘实时响应
• 常见问题FAQ —— 解决乱码、无限循环、输入缓冲三大痛点
• 搜索引擎优化要点 —— 结合Google/Bing排名规则的内容结构复盘

为什么选择PHP做CLI游戏？

许多开发者认为PHP仅服务于Web页面，实则其内置的php://stdin、php://stdout流接口和readline()函数，完全具备构建交互式终端应用的潜力，相比Python或Node.js，PHP的CLI模式无需额外运行时，且在服务器环境中已广泛部署，学习成本几乎为零，更重要的是，通过CLI游戏练习，你能深入理解进程控制、事件循环和用户输入流处理——这些技能对于开发高并发的WebSocket服务或队列Worker同样至关重要。

环境准备与核心概念

运行PHP CLI脚本

php your_game.php

需确保PHP安装时启用php-cli模块（Linux/macOS通常自带，Windows需配置环境变量）。

三个关键函数

• fgets(STDIN)：从标准输入读取一行（注意去除末尾换行符trim()）。
• fwrite(STDOUT, "...")：向标准输出写入文本（比echo更底层，避免缓冲问题）。
• stream_set_blocking(STDIN, false)：将输入设为非阻塞模式（用于实现「按任意键继续」或实时按键检测）。

终端控制码

使用ANSI转义序列\033[2J清屏、\033[H移动光标到左上角，游戏刷新时先清屏再重绘画面，实现「动画」效果。

实战项目：猜数字游戏（全代码）

<?php
// guess.php
declare(strict_types=1);
function clearScreen(): void {
    fwrite(STDOUT, "\033[2J\033[H");
}
function gameLoop(): void {
    $target = random_int(1, 100);
    $attempts = 0;
    clearScreen();
    fwrite(STDOUT, "🎯 猜一个1-100之间的数字：\n");
    while (true) {
        fwrite(STDOUT, ">>> ");
        $input = trim(fgets(STDIN));
        if (!is_numeric($input)) {
            fwrite(STDOUT, "⚠️ 请输入数字！\n");
            continue;
        }
        $guess = (int)$input;
        $attempts++;
        if ($guess === $target) {
            fwrite(STDOUT, "✅ 恭喜！你用了{$attempts}次猜对了。\n");
            break;
        } elseif ($guess < $target) {
            fwrite(STDOUT, "📈 太小了，再试一次。\n");
        } else {
            fwrite(STDOUT, "📉 太大了，再试一次。\n");
        }
    }
}
gameLoop();

运行效果：每次猜测后，终端动态显示提示，最终统计尝试次数,此代码演示了基本输入循环与条件判断。

进阶：简化版「贪吃蛇」的键盘控制

使用ncurses扩展（需安装：apt-get install php-ncurses或pecl install ncurses）

<?php
// snake.php - 极简版
$screen = ncurses_init();
ncurses_noecho();
ncurses_curs_set(0);
ncurses_timeout(100); // 100ms刷新一次
$x = $y = 10;
$dirX = 1; $dirY = 0;
while (true) {
    ncurses_clear();
    ncurses_mvaddstr($y, $x, "●");
    ncurses_refresh();
    $key = ncurses_getch();
    switch ($key) {
        case KEY_LEFT:  $dirX = -1; $dirY = 0; break;
        case KEY_RIGHT: $dirX = 1;  $dirY = 0; break;
        case KEY_UP:    $dirX = 0;  $dirY = -1; break;
        case KEY_DOWN:  $dirX = 0;  $dirY = 1;  break;
        case 27: // ESC键退出
            ncurses_end();
            exit(0);
    }
    $x += $dirX; $y += $dirY;
    // 边界检测（省略）
}

重点解析：ncurses_timeout()控制非阻塞输入，getch()获取按键，使游戏循环持续响应键盘操作，这是Python/Java等语言中游戏开发的通用模式,PHP同样能胜任。

常见问题FAQ（必看）

Q1：运行脚本时出现中文乱码？ → 在脚本开头添加setlocale(LC_ALL, 'zh_CN.UTF-8');，并确保终端编码设置为UTF-8，Windows用户需chcp 65001切换代码页。

Q2：fgets(STDIN)读取后总是多一个换行？ → 这是正常行为，用trim()去除即可，若需保留空格，只去掉换行：rtrim($input, PHP_EOL)。

Q3：如何实现「按任意键继续」？

fwrite(STDOUT, "按任意键继续...");
stream_set_blocking(STDIN, false);
fgetc(STDIN); // 读取单个字符
stream_set_blocking(STDIN, true);

Q4：脚本运行后终端光标消失或画面残留？ → 退出前使用\033[?25h恢复光标显示，\033[2J\033[H清屏并回位。

面向SEO的内容结构复盘

在撰写本文时，我刻意遵循Google核心网页指标和Bing的内容质量准则：含核心关键词 「PHP + CLI游戏」前置，并附加价值描述。 2. 目录锚点 使用HTML标题层级<h2>/<h3>，便于搜索引擎爬取正文结构。 3. 问答模块 直接回答用户长尾搜索问题（如“乱码”、“输入缓冲”），符合Google侧重问题解答的SERP特性。 4. 代码实操优先 提供可复制运行的代码块，增加页面停留时间与回链率。 5. 内链策略** 自然嵌入「PHP流操作」「ncurses扩展」等概念词,但避免过度堆砌。

最后提醒：虽然本文示例简单，但已覆盖CLI游戏开发的核心方法论——掌握了输入输出流、非阻塞读键盘和刷新循环，你便能扩展出俄罗斯方块、命运轮盘等更复杂游戏，打开终端,让PHP为你展现另一面吧！