PHP解释器路径配错会导致所有功能失效：PhpStorm无内置PHP运行时，路径错误将使random_bytes()无法识别、Composer报错；需在Settings→PHP中确认路径真实可执行，且CLI与Web环境的php.ini必须分别检查并同步启用openssl等依赖扩展。
PHP解释器路径配错会导致所有功能失效
PhpStorm本身不带PHP运行时，所有代码提示、调试、运行都依赖你指定的php可执行文件。一旦路径选错（比如指向了php-cgi或旧版本php.exe），random_bytes()这类函数就不会被识别，composer install也报找不到命令。
- 在
File → Settings → Languages & Frameworks → PHP中检查 Interpreter 路径是否真实存在且可执行 - 终端里运行
php --version和 PhpStorm 里显示的版本必须一致，否则php.ini加载路径会错乱 - Windows 下特别注意：别选
php-win.exe（无控制台输出），要选php.exe - macOS/Linux 用户如果用
brew install php，默认路径通常是/opt/homebrew/bin/php或/usr/local/bin/php，不是/usr/bin/php
php.ini 修改后 CLI 和 Web 环境不一致
你在 PhpStorm 里跑测试脚本用的是 CLI 模式，但浏览器访问用的是 Apache/FPM，两者加载的 php.ini 完全不同。比如开了 extension=openssl，CLI 能用 random_bytes()，但 Web 页面仍报 Call to undefined function random_bytes()，就是这个原因。
- 查 CLI 配置：终端执行
php --ini，看Loaded Configuration File - 查 Web 配置：写个
<?php phpinfo(); ?>页面，在浏览器打开，搜索Loaded Configuration File -
random_compat依赖openssl、libsodium或/dev/urandom，确保对应扩展在两个环境里都启用 - 改完
php.ini后，CLI 不用重启，但 Apache/FPM 必须重启：sudo systemctl restart apache2或sudo systemctl restart php8.1-fpm
random_compat 自动加载失效的常见原因
即使 composer install 成功，random_bytes() 还是报未定义，大概率是 autoloader 没触发或被覆盖。
- 确认
composer.json的autoload段包含"psr-4": {"ParagonIE\RandomLib\": "lib/"}类似映射（random_compat实际用的是 PSR-0） - 检查项目根目录是否真有
vendor/autoload.php，且代码开头写了require 'vendor/autoload.php'; - PhpStorm 默认不会自动索引
vendor外部路径，右键vendor目录 →Mark Directory as → Excluded反而会破坏补全——正确做法是保持它为普通目录，让 IDE 自动解析 autoload - 如果用了自定义 autoloader（比如 CodeIgniter 2.x），需手动
include或requirevendor/paragonie/random_compat/lib/random.php
Psalm 静态分析集成后报错却没提示
random_compat 自带 psalm.xml，但 PhpStorm 默认不启用 Psalm 检查，导致类型错误、函数签名不匹配等问题被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 先装 Psalm：
composer require --dev vimeo/psalm - 在
Settings → Languages & Frameworks → PHP → Psalm中填入vendor/bin/psalm路径 - 务必勾选
Run Psalm on the fly，否则只在手动运行时检测 - Psalm 对
random_int()的返回类型有严格推断，若你传入非 int 常量（比如'1'），它会标红并提示InvalidArgument，比 PHP 自身报错早得多
php.ini 是否同步生效——尤其当你在 WAMP/XAMPP 环境下，CLI 和 Apache 的 php.ini 往往分处不同子目录，改了一个另一个没动，random_bytes() 就始终处于“半可用”状态。 
