PHP 8.3随机扩展笔记需建立结构化归档路径，强制绑定日期与Git哈希，分cli_output/、ini_configs/、test_cases/三层存储原始记录，用符号链接指向最新归档，并通过quick-snapshot.sh自动捕获配置快照。
PHP 8.3随机扩展笔记归档需绕过临时草稿、手动整理和模糊命名三大陷阱，直接建立可检索、可回溯、与源码强绑定的结构化存储路径，确保每次调试输出、配置变更或函数测试结果都能被准确定位到对应版本与上下文。
生成带时间戳与扩展标识的归档目录
在项目根目录下执行：mkdir -p php83-random-notes/$(date +%Y%m%d)/ext_random_83_$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")。
这一步强制将笔记与当天日期和当前扩展 Git 提交短哈希绑定，避免多人协作时笔记混杂。若未初始化 Git 仓库，会 fallback 到 “unknown”，但【必须补上 git init && git add . && git commit -m "init"】，否则后续无法追溯配置变更源头。
进入该目录：cd $_。
立即学习“PHP免费学习笔记（深入）”；
按类型分层存放原始记录
在归档目录内创建三个子目录：cli_output/、ini_configs/、test_cases/。
cli_output/ 存放所有终端直跑命令的原始输出，文件名格式为 php_v-output_$(date +%H%M%S).txt，例如 php_v-output_142305.txt 记录 php -v 结果；php_m-output_142307.txt 记录 php -m | grep random 输出——不重命名、不编辑、不合并，保留原始时序与换行。
ini_configs/ 存放 CLI 和 Web 两套 php.ini 中与 random 扩展相关的完整段落截图（用 grep -A5 -B5 "random" /etc/php/8.3/cli/php.ini），文件名含环境标识，如 cli_php_ini_snippet_20260827.txt。
test_cases/ 存放最小可复现脚本，每个脚本以功能命名并带 PHP 版本后缀：Randomizer_getBytesFromString_83.php、random_int_range_check_83.php，不使用 test.php 这类泛称。
用符号链接绑定源码与笔记
回到扩展源码根目录，执行：ln -sf $(pwd)/php83-random-notes/$(date +%Y%m%d)/ext_random_83_$(git rev-parse --short HEAD) ./docs/notes_latest。
这一步让 ./docs/notes_latest 始终指向最新一次归档，无需每次手动更新路径。下次归档前，先 rm docs/notes_latest 再重新执行 ln 命令即可覆盖。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
注意：【符号链接必须用绝对路径或相对于源码根目录的相对路径，禁止用 ~/ 或 $HOME】，否则 CI 环境或他人 clone 后链接失效。
自动提取关键配置快照
编写 quick-snapshot.sh 并放入归档目录：
#!/bin/bash
echo "--- PHP CLI VERSION ---" > config_snapshot_$(date +%s).log
php -v >> $_
echo -e "\n--- RANDOM EXTENSION STATUS ---" >> $_
php -r "var_dump(extension_loaded('random'));" >> $_
echo -e "\n--- INI VALUES ---" >> $_
php -r "echo 'default_seed: ' . ini_get('random.default_seed') . PHP_EOL;" >> $_
赋予执行权限：chmod +x quick-snapshot.sh，运行它生成带时间戳的快照日志。
这一步比人工 copy-paste 更可靠，避免漏掉 ini_get() 返回 false 却误判为 true 的情况。
