Composer需全局安装并验证可用，再用composer require alipay-sdk-php引入官方SDK，通过vendor/autoload.php自动加载，注意PHP版本、扩展、密钥格式及命名空间匹配。
Composer 本身不是“安装”在项目里，而是先全局安装在系统中，再用它来管理 PHP 项目的依赖——包括支付宝官方提供的 alipay-sdk-php（注意：没有叫 SDK_composer 的包，这是常见误解）。
确认 Composer 已正确安装并可用
运行 composer --version 能输出版本号，才说明 Composer 可用。Windows 用户常遇到的问题是 PATH 没配好，或者装了多个 PHP 版本导致 php 命令指向错误的可执行文件。
- Linux/macOS：推荐用官方脚本安装：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f828066a1fd4fe06bdbb6c5bfc8ff93915363af3bf129d278a031b2304f8d88e160cd4167d5a20997038732446b2') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" php composer-setup.php sudo mv composer.phar /usr/local/bin/composer - Windows：直接下载
Composer-Setup.exe安装，安装时务必勾选 “Add to PATH”；装完后重启终端再验证 - 如果
composer命令报错提示找不到php，检查php -v是否正常，以及which php（macOS/Linux）或where php（Windows）返回路径是否合理
使用 composer require 引入支付宝 SDK
支付宝官方维护的 PHP SDK 包名是 alipay-sdk-php，发布在 Packagist 上，不是私有包，无需额外配置仓库地址。
- 进入你的 PHP 项目根目录（确保该目录下有
composer.json或能生成它），执行：composer require alipay-sdk-php
- 成功后会自动写入
composer.json的require字段，并下载到vendor/alipay-sdk-php/ - 不要手动下载 ZIP 或 clone 仓库——这会导致 autoloader 失效、版本难管理、无法享受 Composer 的依赖解析能力
- 如果你看到
Could not find package alipay-sdk-php，大概率是拼错了名字（比如写成alipay-sdk-composer、alipay_php_sdk等），请严格按官网文档写的包名输入
在项目中加载并初始化 SDK
Composer 默认启用 PSR-4 自动加载，只要引入 vendor/autoload.php，就能直接 new 类。
立即学习“PHP免费学习笔记（深入）”；
- 确保你在 PHP 脚本开头已包含：
require_once __DIR__ . '/vendor/autoload.php';
- 初始化示例（以支付宝 APP 支付为例）：
$config = [ 'app_id' => 'your_app_id', 'merchant_private_key' => '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE KEY-----', 'alipay_public_key' => '-----BEGIN PUBLIC KEY-----...-----END PUBLIC KEY-----', 'sign_type' => 'RSA2', 'debug' => true, ]; $client = new \Alipay\AopClient(); $client->gatewayUrl = 'https://openapi.alipay.com/gateway.do'; $client->appId = $config['app_id']; $client->rsaPrivateKey = $config['merchant_private_key']; $client->alipayPublicKey = $config['alipay_public_key']; $client->signType = $config['sign_type']; - 注意：密钥内容必须是完整字符串（含
-----BEGIN...行），不能被 PHP 截断或转义；建议从文件读取，而非硬编码在代码中 - 如果报错
Class 'Alipay\AopClient' not found，说明 autoload 没生效，检查路径是否正确、是否漏了require_once、是否用了错误的命名空间（新版 SDK 使用\Alipay\*，旧版是\AlipayAop\*，认准你装的版本）
常见兼容性与安全提醒
支付宝 SDK 对 PHP 版本和扩展有明确要求，忽略会导致运行时报错或签名失败。
- PHP 版本：最低要求
7.2，但强烈建议用8.0+；alipay-sdk-phpv4+ 已不支持 PHP 7.1 - 必需扩展：
openssl（签名验签）、curl（HTTP 请求）、json（响应解析）；用php -m | grep -E 'openssl|curl|json'快速确认 - 密钥格式必须为 PEM，且私钥不能加密（即不能有
DEK-Info行）；若用 OpenSSL 生成，命令应为：openssl genrsa -out app_private_key.pem 2048 openssl rsa -in app_private_key.pem -pubout -out app_public_key.pem
- 生产环境务必关闭
debug，否则日志可能泄露敏感信息；同时避免将密钥提交到 Git，用.env+vlucas/phpdotenv更安全
真正卡住人的往往不是 composer 命令本身，而是密钥格式不对、PHP 扩展缺失、命名空间写错、或者误信网上过时的“SDK_composer”别名。盯住 composer show alipay-sdk-php 看实际装的是哪个版本，再对照 GitHub 上对应 tag 的 README 写法，比搜“教程”靠谱得多。
