需手动配置 GitHub 仓库并指定 robertlemke/vendor 名安装，补全 autoload files 配置，调用 intFromBytes 时必须显式传入 $signed=true 和正确字节序参数。
composer require 时提示 package not found 怎么办
PHP-Binary-Utils 并不是 Packagist 官方注册的包，直接运行 composer require php-binary-utils/php-binary-utils 会报错 Package php-binary-utils/php-binary-utils not found。它实际托管在 GitHub，且未发布到 Packagist，必须手动配置仓库源。
- 在项目根目录的
composer.json中添加"repositories"字段，指向其 GitHub 主页："repositories": [ { "type": "vcs", "url": "https://github.com/robertlemke/php-binary-utils" } ] - 再执行
composer require robertlemke/php-binary-utils:dev-master（注意 vendor 名是robertlemke，不是php-binary-utils） - 若项目启用了
minimum-stability: stable，需临时加--stability=dev或在composer.json中显式允许 dev 分支
require 后无法 autoload 类：Class not found 错误
该库没有标准 PSR-4 命名空间映射，也不含 autoload 配置，Composer 默认不会自动加载它的类。手动引入或补全 autoloading 是必须步骤。
- 确认安装后文件路径为
vendor/robertlemke/php-binary-utils/Classes/，里面是传统 PHP 文件（如BinaryUtils.php），非命名空间类 - 最简方案：在使用前用
require_once显式加载，例如：require_once __DIR__ . '/vendor/robertlemke/php-binary-utils/Classes/BinaryUtils.php';
- 更可持续的做法：在
composer.json的autoload→files中添加该路径："autoload": { "files": ["vendor/robertlemke/php-binary-utils/Classes/BinaryUtils.php"] }然后运行composer dump-autoload
BinaryUtils::intFromBytes() 返回值异常或符号错误
这个函数默认按无符号整数解析字节，但底层数据可能带符号（比如有符号 short/int），不指定参数会导致高位溢出后数值翻转（如 0xFFFE 变成 65534 而非 -2）。
- 关键参数是
$signed和$endianness：前者控制是否按补码解释，后者决定字节序（BinaryUtils::ENDIAN_BIG或BinaryUtils::ENDIAN_LITTLE） - 常见误用：
BinaryUtils::intFromBytes("\xFE\xFF", 2)默认返回 65534；正确应写成BinaryUtils::intFromBytes("\xFE\xFF", 2, true, BinaryUtils::ENDIAN_BIG)才得 -2 - 注意长度参数必须精确匹配字节数，传错（如传 4 但只给 2 字节）会触发
Notice: Undefined offset
处理大端/小端混合数据流时容易混淆字节序
网络协议或嵌入式二进制格式常混合大小端（例如头部大端、负载小端），而 BinaryUtils 每次调用只能指定一种字节序，反复切换易出错。
立即学习“PHP免费学习笔记（深入）”；
- 不要靠记忆切换，把字节序作为上下文显式传递：定义常量
HEADER_ENDIAN = BinaryUtils::ENDIAN_BIG、PAYLOAD_ENDIAN = BinaryUtils::ENDIAN_LITTLE - 对连续字段，优先用
BinaryUtils::unpack()一次性解析（支持格式字符串如"nN"），比多次调用intFromBytes()更可靠 - 调试时用
bin2hex()先确认原始字节顺序，再决定传哪个ENDIAN_*常量——别假设“网络字节序就是大端”就跳过验证
