如何使用Composer引入 PHP-Twilio 库在应用中集成短信发送与语音通话-composer-PHP中文网

是，twilio官方php sdk（twilio/sdk）仍在维护，当前最新稳定版为^8.0，要求php≥7.4，需卸载已废弃的php-twilio并清理残留配置后通过composer require twilio/sdk安装。

如何使用composer引入 php-twilio 库在应用中集成短信发送与语音通话

确认 Twilio 官方 PHP SDK 是否仍被维护

直接用 composer require twilio/sdk 装的是 Twilio 官方维护的 SDK，不是第三方叫 “PHP-Twilio” 的库——后者早在 2016 年就停止更新，且不兼容 PHP 7.4+ 和现代 autoloader 规范。强行安装会报 Class 'Services_Twilio' not found 或 Cannot declare class Twilio\Rest\Client 冲突错误。

所以第一步不是搜 “PHP-Twilio”，而是认准官方包：twilio/sdk（当前最新稳定版为 ^8.0）。

旧项目若已用过废弃的 php-twilio，必须先删掉 require 行、删除 vendor/sergeytsalkov/php-twilio 目录，再清空 composer.lock
检查 composer.json 中是否残留 "php-twilio": "*" 或类似条目，删掉
运行 composer update 前确保 PHP 版本 ≥ 7.4（官方 SDK v8 要求）

安装与基础初始化要避开 autoloader 冲突

执行 composer require twilio/sdk 后，SDK 自动注册 PSR-4 autoloader，不需要手动 require 'vendor/autoload.php' —— 但前提是你的项目本身已正确加载 Composer autoloader。

常见出错点：

在非 Composer 管理的脚本里直接 require 'vendor/twilio/sdk/Twilio/autoload.php'：这是旧版写法，v8 已移除该文件，会报 failed to open stream
忘记在入口文件（如 index.php）顶部加 require 'vendor/autoload.php';：导致 Twilio\Rest\Client 找不到类
使用 Laravel/Symfony 等框架时，没执行 composer dump-autoload 就改了命名空间：类加载失败，错误信息是 Class 'Twilio\Rest\Client' not found

正确初始化示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php require 'vendor/autoload.php';

use Twilio\Rest\Client;

$sid = 'your_account_sid';
$token = 'your_auth_token';
$client = new Client($sid, $token);

发短信和打语音电话的参数差异不能混用

同一个 Client 实例可复用，但短信（messages）和语音（calls）调用路径、必填参数、返回结构完全不同，不能套用同一套逻辑。

发短信必须用 $client->messages->create()，关键参数是 from（Twilio 号码）、to（目标号码，带 +86）、body（文本）
打语音必须用 $client->calls->create()，关键参数是 from、to、url（指向 TwiML 的 HTTPS 地址，不是语音内容本身）
url 返回的必须是合法 TwiML，例如 <response><say voice="alice">Hello</say></response>，否则呼叫会立刻挂断并报 HTTP retrieval failed
测试时别用个人手机号当 from：Twilio 只允许验证过的号码或购买的号码作为发送方，否则抛出 Unable to create record: The 'From' number is not a valid phone number

环境变量管理不当会导致部署失败

把 account_sid 和 auth_token 写死在代码里是高危操作，但仅靠 .env 文件不等于自动生效——Twilio SDK 不读取 .env，需你自己注入。

推荐用 getenv('TWILIO_ACCOUNT_SID') 或 $_ENV['TWILIO_ACCOUNT_SID']，并在部署前确认 Web 服务器（如 Nginx/Apache）允许 PHP 读取环境变量（Apache 需 SetEnv，Nginx 需 fastcgi_param）
Laravel 用户可直接用 config('services.twilio.sid')，但要确保 config/services.php 里已定义对应键
Docker 部署时，别只写 ENV TWILIO_ACCOUNT_SID=xxx 在 Dockerfile 里——容器启动时需通过 -e 或 .env 映射传入，否则 getenv() 返回 false