Composer钩子写中文日志乱码的根本原因是系统编码与PHP文件写入未统一为UTF-8，需显式用mb_convert_encoding()转换并添加BOM；同时应避免require vendor/autoload.php，改用autoload-dev注册类。
Composer钩子函数里写中文日志为什么乱码
直接用 file_put_contents() 写中文到日志文件，大概率出现乱码，根本原因是 Composer 进程默认不指定文件编码，而 PHP 脚本执行环境（尤其是 Windows 或某些 Linux 终端）常以 GBK/GB2312 或 UTF-8-BOM 混用方式处理中文。更关键的是：composer install 或 update 启动时，$_SERVER['PATH'] 和 locale 环境可能未设为 UTF-8，导致 fopen()、file_put_contents() 底层调用忽略 BOM 且按系统默认编码解释字节。
- Windows 下 CMD/PowerShell 默认 code page 是 936（GBK），即使 PHP 文件保存为 UTF-8，输出到文件也不自动转码
- Linux 上若
LANG未设为en_US.UTF-8或zh_CN.UTF-8，mb_internal_encoding()可能仍为ISO-8859-1 - 不要依赖
ini_set('default_charset', 'UTF-8')—— 它只影响 HTML 输出，对文件写入无效
正确做法是显式声明编码并强制转换：用 mb_convert_encoding($str, 'UTF-8', 'auto') 处理输入，再以 FILE_APPEND | LOCK_EX 方式写入，并在首行写入 UTF-8 BOM（仅当需确保 Windows 记事本正确识别时）。
在 post-install-cmd 钩子里记录包安装状态的实操写法
Composer 的钩子（如 post-install-cmd）运行在命令执行完成后，此时 composer.lock 已生成，但 vendor/ 目录下包已解压完毕。想追踪“哪些包被新安装/更新/跳过”，不能只看钩子触发时机，得结合 composer show --direct --format=json 或解析 composer.lock 对比前后状态 —— 但钩子本身没有“上一次 lock”的快照。所以实用策略是：把状态记录拆成两步，用外部标记文件做轻量对比。
- 在
pre-install-cmd钩子中，先备份当前composer.lock的 SHA256 到临时文件（如./.lock-hash.pre） - 在
post-install-cmd钩子中，重新计算composer.lockSHA256，与备份比对；若不同，说明有变更，再用json_decode(file_get_contents('composer.lock'), true)提取packages列表 - 注意：钩子脚本里别直接用
shell_exec('composer show ...')，会递归触发钩子，造成死循环 - 日志内容建议包含：时间戳、钩子名、PHP 版本、当前工作目录、变更包数量、前 3 个变更包名（防日志爆炸）
示例片段（放在 scripts.php 中）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
public static function logInstallStatus()
{
$logFile = 'logs/composer-hooks.log';
$lockPath = 'composer.lock';
if (!is_file($lockPath)) return;
$content = file_get_contents($lockPath);
$hashNow = hash('sha256', $content);
$hashPrev = @file_get_contents('./.lock-hash.pre') ?: '';
$status = $hashNow === $hashPrev ? 'no-change' : 'changed';
$packages = $status === 'changed' ? array_column(json_decode($content, true)['packages'] ?? [], 'name') : [];
$msg = sprintf(
"[%s] %s: %s, packages: %d%s
",
date('Y-m-d H:i:s'),
'post-install-cmd',
$status,
count($packages),
$packages ? ', '.implode(', ', array_slice($packages, 0, 3)) : ''
);
// 强制 UTF-8 + BOM
$bom = "";
file_put_contents($logFile, mb_convert_encoding($bom . $msg, 'UTF-8', 'auto'), FILE_APPEND | LOCK_EX);
}
钩子函数中访问 vendor/autoload.php 的坑
很多人在钩子脚本里直接 require 'vendor/autoload.php'，结果报错 Class not found 或 Cannot redeclare class。这是因为 Composer 钩子执行时，当前 autoloader 尚未完全加载（尤其在首次 install 时 vendor/ 还没建好），或多个钩子并发写入导致 autoload 文件被覆盖中。
- 不要在钩子中 require vendor/autoload.php —— Composer 在执行钩子前已内置 autoloader，你写的类只要注册在
autoload配置里就能用 - 如果必须用第三方库（如 Monolog），应在
require-dev中声明，并确保钩子脚本路径在autoload-dev里注册过 - 更稳妥的方式：所有钩子逻辑封装进独立类，该类通过
composer.json的autoload-dev注册，然后钩子只调用静态方法，避免任何手动 require - 验证方式：在钩子函数开头加
var_dump(class_exists('Your\Hook\Class'));，若为 false，说明 autoloading 没生效
Windows 下中文日志被截断或换行错乱
Windows 记事本对 LF（ ）换行支持差，而 PHP 默认用 ，不是 。如果日志里中文 + 混合，记事本会显示成一行挤在一起，看起来像“被截断”。这不是乱码，是换行符问题。
- 开发阶段用 VS Code、Notepad++ 或 Vim 查看日志，它们默认识别 LF
- 若必须兼容记事本，写日志时用
str_replace(" ", " ", $msg)，但注意：这会让日志在 Linux 下多出空行，仅建议用于内部运维场景 - 另一个干扰项：CMD 窗口缓冲区大小限制，默认只存最后 300 行，旧日志被刷掉 —— 这不是钩子问题，是终端配置
- 真正容易被忽略的是：钩子脚本文件本身编码。务必确认
scripts.php是 UTF-8 无 BOM 格式（BOM 会导致 PHP 解析失败，报Parse error: syntax error）
复杂点在于：日志既要人可读（Windows 记事本能打开）、又要机器可解析（grep / jq 处理），所以推荐统一用 UTF-8 + LF，配一个最小化查看脚本，而不是迁就记事本。
