PHP CLI不支持“import”命令,需用require/__DIR__定位文件或Composer自动加载;require_once在每次CLI执行中独立生效,防重入需逻辑判断而非依赖该机制。

PHP 最新版本身不提供“导入”命令行功能——你不能像 npm install 那样用 php import xxx 导入东西。所谓“命令行导入”,实际是指在 CLI 环境下加载和执行其他 PHP 文件(如配置、工具类、依赖脚本),或通过 Composer 加载第三方包。关键在于理解 PHP CLI 的文件包含机制与自动加载限制。
php 命令行里怎么 include/require 其他文件
CLI 模式下 include、require、include_once、require_once 完全可用,但路径解析和 Web 环境不同:当前工作目录(getcwd())是起始点,不是脚本所在目录。
- 用相对路径时,务必注意执行位置 ——
php /path/to/script.php时,require 'config.php'是从你当前终端所在目录找,不是从/path/to/找 - 更可靠的方式是基于脚本自身定位:
require __DIR__ . '/config.php';(__DIR__永远指向当前文件所在目录) - CLI 默认不启用
open_basedir限制,但若 PHP 配置了它,路径必须在其白名单内,否则报错Warning: require(): open_basedir restriction in effect -
require失败会触发Fatal error并退出;include只警告,脚本继续执行 —— 脚本初始化阶段建议用require
PHP 8.2+ CLI 怎么用 Composer 自动加载
Composer 的 autoload 在 CLI 下照常工作,但前提是你的脚本是作为 Composer 项目的一部分启动,且已运行过 composer install。
- 确保项目根目录下有
vendor/autoload.php - 在主脚本开头写:
require __DIR__ . '/vendor/autoload.php'; - 之后就能直接
new Some\Package\Class();,无需手动require每个文件 - 如果用
php -r临时测试,不能直接用自动加载 ——php -r "require 'vendor/autoload.php'; echo (new \Monolog\Logger('test'))->info('ok');"会失败,因为-r不支持跨行或复杂依赖链;应改用完整脚本文件
为什么 require_once 在 CLI 多次执行时仍可能重复加载
CLI 脚本每次调用都是全新进程,require_once 的“已加载”状态不会跨进程保留 —— 这和 Web SAPI(如 FPM)中请求间共享内存不同。
- 现象:你在终端连续执行两次
php script.php,require_once 'helper.php'会分别执行两次(只要 helper.php 内部没做额外判断) - 这不是 bug,是设计使然:每个 CLI 进程独立,
require_once只在单次执行生命周期内生效 - 如果你需要全局唯一初始化(比如注册错误处理器、设置时区),应在主入口脚本中集中处理,而不是依赖
require_once防重入 - 真正防重入要靠逻辑判断,例如:
if (!defined('HELPER_LOADED')) { define('HELPER_LOADED', true); ... }
最易被忽略的是路径上下文切换 —— 很多人在 cron 或 systemd service 里跑 CLI 脚本,却忘了 cd 到正确目录或用 __DIR__ 锚定路径,结果 require 报错找不到文件,而本地测试时一切正常。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











