尧图网页设计 
简介这是一套基于百度API开发的PHP在线文字转语音合成源码面向需要为网站或应用快速接入TTS功能的PHP开发者省去从零实现底层合成逻辑的繁琐过程。压缩包共201个文件以JS和CSS静态资源为主同时包含PHP入口文件、HTML页面、字体及映射文件等整体仅1.4MB结构轻量便于部署与二次开发。目前已有65人浏览学习。源码完整演示了从用户输入文本、调用百度TTS接口、生成音频到在线播放与下载的闭环流程。开发者可借此掌握第三方API的调用方式、密钥管理与鉴权、网络通信处理、错误捕获以及音频文件生成等关键环节。前端界面与后端逻辑分离清晰适合作为PHP网络编程、接口对接的实战学习案例也可直接改造用于自有项目提升产品的信息无障碍与交互体验。1. 在线文字转语音扩展包PHP源码里最值得先读的百度API部分当你拿到一个“PHP在线文字转语音合成源码 基于百度API开发.zip”这类压缩包第一感觉通常是里面有一个后台界面、一个输入框、一个播放按钮。真正决定这套源码能不能上线的却是它怎么处理百度API的鉴权、怎么接收音频流、遇到错误怎么回退。做内容站的人需要把文章转成音频做小工具站的人需要批量生成语音运营同学还想在后台看到合成记录这些需求都会落在同一个根上PHP与百度API之间的那几次请求。这篇文字从“拿到一个TTS源码后该怎么改”的角度把鉴权、参数、文件处理、并发和部署这几个环节拆开讲。刚接触PHP的能把代码抄回去跑通写过几年后台的也能在边界条件和错误处理上少走点弯路。2. 百度API鉴权与合成参数PHP代码影响最大的三件事2.1 先弄清楚一次合成请求涉及哪几步百度语音合成可以简单理解成一个REST接口客户端把文字和参数通过POST或GET发过去服务端返回一段音频也可能返回一段错误JSON。PHP在线TTS源码做得是否健壮就看它有没有把这两类返回区分开。完整链路通常分两步用百度云控制台里创建的API Key和Secret Key换取Access Token把Access Token随合成参数一起发给语音合成的HTTP接口拿到MP3或PCM数据。token的有效期一般有几十天但每次请求都重新换取没必要。源码里如果每次合成前都重新get_token就会出现两个隐患一是多了一次网络往返页面响应慢二是并发高时可能触发频率限制。第4章会讲怎么缓存。这里先记住一个结论百度API对你项目的影响不在“能不能调通”而在“token怎么存、错误怎么判”。下面用表格把鉴权环节最关键的信息列出来配置项你在百度控制台拿到的内容PHP源码里的常规处理API Key应用创建后的Client ID存在config文件或环境变量里Secret Key应用创建后的Client Secret存在服务端配置里不要暴露给前端Access Token用上面两项换取的临时票据缓存后复用减少鉴权请求合成接口地址百度语音合成REST地址用cURL发请求不使用file_get_contents2.2 合成参数里最容易影响PHP代码设计的是aue和per调用百度API合成时tex是文字tok是tokencuid通常写应用标志。比较少被讲清楚的是aue和per这两个参数。aue控制输出格式常见值3表示MP34表示PCM。源码里如果只做页面播放MP3就够了但如果你想在音频后面拼接片头、做音量归一化PCM或WAV处理起来更方便转码时会少一道有损解码。per是人声选项常见0、1、3、4等。这个参数不改变代码结构但影响用户观感。有一个容易踩的坑per和aue并不完全独立在某些账号权限下部分音色只支持特定格式代码里如果硬编码aue3用户选了不支持的音色接口返回错误时页面上却只显示“合成失败”看不出原因。所以健壮的源码在发起请求前会先把参数范围做服务端校验。给一个便于排查参数字段的对照参数含义我习惯的设定tex要合成的文字先trim再校验长度spd语速0-155或6pit音调0-155vol音量0-155后台可调per音色编号0女声1男声3度逍遥4度丫丫aue音频格式3MP34PCMctp客户端类型固定1按百度文档要求填lan语言zh中文合成tok访问凭证从缓存中读取不存在则重新获取提示token获取接口与合成接口的鉴权方式不同合成接口通过表单字段tok传入不是放在HTTP Authorization头里。2.3 为什么PHP源码的重点是“先看返回内容再决定写文件”很多人在第一次写百度语音合成PHP代码时直接把curl_exec()返回值写入文件。这在合成成功时没问题接口返回的二进制头部正好是音频的魔数比如MP3以ID3或0xFF开始。一旦文字过长、文字里有特殊符号、token过期接口会返回一个很小的JSON字符串例如{err_no:3301,err_msg:Access token invalid or no longer valid,sn:...}如果源码不做类型判断就会生成一个几十字节的“音频文件”浏览器播放自然失败。正确的做法是先在PHP侧判断响应最前面的字符是不是{或者直接读取响应的Content-Type。常见做法是下面这样$response curl_exec($ch); $contentType curl_getinfo($ch, CURLINFO_CONTENT_TYPE); if (strpos($contentType, application/json) ! false) { $error json_decode($response, true); throw new RuntimeException(合成失败错误码 . $error[err_no] . 信息 . $error[err_msg]); } file_put_contents($savePath, $response);这里先用curl_getinfo拿到Content-Type。百度API对错误返回固定给JSON所以一旦是JSON就直接进入异常处理不会污染音频目录。这样设计之后源码就同时具备了正确写入音频、以及把失败原因透出到日志或页面两个能力。第3章就按照这个思路写一套最小可用的PHP实现。3. 用PHP写文字转语音请求从token到MP3落盘的实现3.1 封装一个token获取函数不管源码界面有多花哨核心永远是token。下面这段代码可以直接放到类里也可以当作单文件脚本用function getAccessToken(string $apiKey, string $secretKey): string { $url https://aip.baidubce.com/oauth/2.0/token; $postData [ grant_type client_credentials, client_id $apiKey, client_secret $secretKey, ]; $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_POST true, CURLOPT_POSTFIELDS http_build_query($postData), CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT 10, ]); $response curl_exec($ch); $httpCode curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode ! 200 || $response false) { throw new RuntimeException(获取access_token失败HTTP状态码 . $httpCode); } $data json_decode($response, true); if (!isset($data[access_token])) { throw new RuntimeException(获取access_token返回异常 . $response); } return $data[access_token]; }这个函数要做的事情很直接用百度OAuth接口的client_credentials模式换取token。grant_type是OAuth标准参数client_id对应API Keyclient_secret对应Secret Key。我在返回时只保留access_token把expires_in留给调用方缓存层判断。需要留意的是有些老代码会用CURLOPT_HTTPHEADER把token放在header里那是另一个接口的写法语音合成接口的token是通过POST字段或query参数传递的不要混用。3.2 合成接口的PHP调用与音频保存拿到token后下一步是调语音合成接口。这里一般用POST参数直接用表单格式。代码里我会把保存路径设计成调用方传入方便后续做按日期分目录function textToMp3(string $text, string $token, string $savePath): bool { $url https://tsn.baidu.com/text2audio; $postData [ tex $text, tok $token, cuid php-tts-demo, ctp 1, lan zh, spd 5, pit 5, vol 5, per 0, aue 3, ]; $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_POST true, CURLOPT_POSTFIELDS http_build_query($postData), CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT 30, CURLOPT_HTTPHEADER [Accept: audio/mp3], ]); $response curl_exec($ch); $contentType curl_getinfo($ch, CURLINFO_CONTENT_TYPE); $httpCode curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode ! 200) { throw new RuntimeException(语音合成接口HTTP错误 . $httpCode); } if (strpos($contentType, application/json) ! false || strpos($response, {) 0) { $err json_decode($response, true); throw new RuntimeException(语音合成失败[ . $err[err_no] . ] . $err[err_msg]); } if (file_put_contents($savePath, $response) false) { throw new RuntimeException(音频文件写入失败 . $savePath); } return true; }这段代码的关键点有三个。第一CURLOPT_TIMEOUT设到30秒因为长文本的合成耗时并不稳定超时太短容易误杀。第二判断错误时先看Content-Type再看返回内容首字符双保险。第三file_put_contents前没有做目录检查所以调用方要保证目录存在否则会得到“写入失败”而不是合成错误排错时会多绕一圈。3.3 把两个函数串成一条可复制的调用链在真实项目里我不会把token获取和合成写进一个函数里因为后续要做缓存和日志分开更清晰。调用链一般长这样require_once tts.php; $apiKey getenv(BAIDU_API_KEY); $secretKey getenv(BAIDU_SECRET_KEY); $token getAccessToken($apiKey, $secretKey); $text 欢迎使用PHP在线文字转语音源码这个请求将被保存为MP3文件。; $dir /data/www/tts/audio/ . date(Ymd); if (!is_dir($dir)) { mkdir($dir, 0755, true); } $savePath $dir . / . md5($text . microtime()) . .mp3; textToMp3($text, $token, $savePath); echo 生成成功: {$savePath}\n;这里有两个常见问题。一是直接用环境变量存密钥比写在配置文件里更安全能避免源码包被传到公网仓库时把密钥一起带出去二是用md5($text . microtime())做文件名主要目的是防止同一段文字重复覆盖。如果你希望相同文字只生成一次文件名直接改成md5($text)再把文件写到固定目录就天然实现了内容去重。这段代码执行成功后可以用file命令在服务器上看一下文件类型确认是真实的MP3而不是错误JSON。如果发现生成的文件只有几十字节就回头检查3.3里的错误分支是否生效。很多“源码包”其实只是把demo里的curl结果直接输出到浏览器没有落盘对比一下当前实现能看出设计上的差别。4. PHP源码上线前的改造缓存、队列与目录权限4.1 用文件或Redis缓存token减少重复换取线上环境里每个用户都可能触发合成如果每次都调用token接口百度API控制台会看到每秒请求数被刷上来后端响应也会变慢。缓存方案很成熟把token存到临时目录的JSON文件里设置较短的有效期读取前先判断过期时间。function getCachedToken(string $apiKey, string $secretKey): string { $cacheFile sys_get_temp_dir() . /baidu_token_ . md5($apiKey) . .json; if (is_file($cacheFile)) { $cache json_decode(file_get_contents($cacheFile), true); if ($cache $cache[expire_at] time()) { return $cache[access_token]; } } $token getAccessToken($apiKey, $secretKey); file_put_contents($cacheFile, json_encode([ access_token $token, expire_at time() 70000, ], JSON_UNESCAPED_UNICODE)); return $token; }这里把过期时间定为70000秒比官方默认的有效期短很多原因是保守一点宁可多换几次也不要因为服务器时钟偏差导致token刚存入就被判失效。使用Redis版时做法类似用SETEX写入72000秒。要注意的是如果多台服务器共用同一份token文件缓存会失效Redis是必须项如果单机使用文件缓存完全够还能少一个依赖。4.2 给合成接口加队列防止瞬间并发打满百度语音合成API对并发和QPS有限制。普通页面如果用户快速点击“生成”请求会直接打到百度接口结果是部分请求返回错误码或者HTTP限制。成熟的PHP源码一般会在textToMp3()外面包一层任务队列先生成任务再由后台进程依次消费。队列最简单的实现是用数据库表CREATE TABLE tts_task ( id INT AUTO_INCREMENT PRIMARY KEY, text_content TEXT NOT NULL, file_path VARCHAR(255) DEFAULT , status TINYINT DEFAULT 0, error_msg VARCHAR(255) DEFAULT , created_at DATETIME DEFAULT CURRENT_TIMESTAMP );消费端脚本我一般会在CLI模式下跑一个常驻进程每5秒查一次待处理记录while (true) { $task $pdo-query(SELECT * FROM tts_task WHERE status0 ORDER BY id ASC LIMIT 1)-fetch(); if ($task) { try { textToMp3($task[text_content], getCachedToken($apiKey, $secretKey), $savePath); $pdo-prepare(UPDATE tts_task SET status1, file_path? WHERE id?)-execute([$savePath, $task[id]]); } catch (Exception $e) { $pdo-prepare(UPDATE tts_task SET status2, error_msg? WHERE id?)-execute([$e-getMessage(), $task[id]]); } } else { sleep(5); } }如果不想引入数据库可以用Redis ListLPUSH入队BRPOP出队。哪个更合适取决于项目现状已有Redis就直接用队列没有的话MySQL更省事。加入队列后还要设置一个最大重试次数。以我的经验合成失败很少因为百度接口本身更多来自token过期和超长文本。所以error_msg字段里除了错误码还建议存下本次请求的tex长度方便后续看出是哪些文字太长。4.3 音频目录权限与Nginx配置的四个坑把源码部署到NginxPHP-FPM环境时音频目录通常是冲突高发区。有四个点我建议直接检查隐患表现解决办法音频目录不可写合成成功但保存失败chown www-data:www-data -R /data/www/tts/audio目录可执行PHP用户上传或生成异常文件时可被解析在Nginx location中排除audio目录的PHP解析文件权限过大其他用户可遍历音频列表外层目录设为0711音频文件设为0644播放路径暴露真实文件名容易被人直接刷接口文件名用随机串不直接带自增IDNginx里加一段就能避免audio目录被当成PHP执行location ^~ /tts/audio/ { expires 30d; add_header Cache-Control public, no-transform; }这段配置里没有FastCGI配置所以任何以/tts/audio/开头的请求都会直接返回静态文件。顺便设置一个30天的缓存过期时间浏览器第二次播放同样音频时就不会再回源到PHP。若源码里音频是动态输出的另一种做法是请求/tts.php?filexxx但那样每次播放都占用一个PHP进程在高并发下得不偿失。线上我优先推荐生成真实MP3文件再让Nginx直接serve。5. 进阶小技巧命令行验证合成链路、安全播放与长文本分批5.1 用PHP CLI做一次端到端验证源码改完后不需要先打开浏览器直接在服务器上用CLI脚本跑通最小链路更高效。把第3章代码存成cli_tts.php然后执行php cli_tts.php脚本结束后用以下命令确认文件类型file /data/www/tts/audio/20250101/*.mp3输出应该包含MPEG ADTS, layer III之类的描述。如果输出是ASCII text说明保存的还是JSON错误信息此时直接查看文件内容就能看到err_msg。这个验证方式比在后台界面上等提示更直接因为CLI脚本会把PHP警告全部打印到终端不容易被框架拦截。5.2 前端播放时如何不暴露百度API密钥在线文字转语音源码的使用场景通常是后台管理员操作但有时也要开放给普通用户使用。此时不能把token、API Key直接放在页面里。常见做法是合成请求经过会话权限校验后返回一个短期有效的音频URL比如/tts/audio/{date}/{random}.mp3。文件下载和播放交给Nginx密钥只存在于服务端配置或环境变量中。如果需要给同一段文字生成多个音色前端可以用audio标签播放audio controls preloadnone src/tts/audio/20250101/a1b2c3d4.mp3/audio如果担心文件被直接遍历更推荐的做法是让Nginx加签名参数校验。对大多数PHP项目来说最简单的做法是把音频文件名设成UUID并放在不可索引目录然后在PHP里用readfile()输出代价是每次播放都会多占一个PHP进程。一句话能静态化就静态化必须动态输出时加鉴权不要裸奔。5.3 长文本拆分的具体粒度百度API的单次合成文本长度有上限超长后接口会直接报错。源码包里如果只做了一段textarea提交遇到几千字文章就会踩到。常见的做法是按标点切分把文章拆成句子数组再批量调用。给一个简单的拆分参考$parts preg_split(/(?[。])/, $text, -1, PREG_SPLIT_NO_EMPTY);每次合成的文本控制在200个中文字符以内既能保证音色自然也能让失败重试的定位更精确。把每段结果文件名保存在数组里最后再通过一个播放列表把多段音频连起来播放。接口没有直接拼接多段MP3的能力所以前端播放器要支持播放列表或者服务端用FFmpeg把多段音频再合成一个文件。后者会多一步转码时间前者实现起来更轻。我一般会选择前端播放列表并为每段音频记录生成时间和文本哈希方便排查是哪一段触发错误码。如果需要合并成单个MP3可以用FFmpeg的concat方式ffmpeg -f concat -safe 0 -i list.txt -c copy out.mp3list.txt里按顺序写入file /data/www/tts/audio/part1.mp3这样的路径。合并时注意所有段必须是同一种采样率和声道数否则直接用-c copy会出现时间偏移。先查一下每段音频的编码参数不一致就在合并前统一转成相同规格再执行上面的命令。以上就是从拿到“PHP在线文字转语音合成源码”到真正能够上线使用的完整路径先确认百度API的鉴权与参数再把请求和处理返回封装成可复用PHP代码上线前补上缓存、队列和目录权限最后用命令行和播放列表把链路验证完整。顺着这条路径去检查手头源码的每个缺口比直接点开浏览器里的“开始合成”按钮要高效得多。本文还有配套的精品资源点击获取 PHP在线文字转语音源码解析：百度API集成与上线部署指南
简介这是一套基于百度API开发的PHP在线文字转语音合成源码面向需要为网站或应用快速接入TTS功能的PHP开发者省去从零实现底层合成逻辑的繁琐过程。压缩包共201个文件以JS和CSS静态资源为主同时包含PHP入口文件、HTML页面、字体及映射文件等整体仅1.4MB结构轻量便于部署与二次开发。目前已有65人浏览学习。源码完整演示了从用户输入文本、调用百度TTS接口、生成音频到在线播放与下载的闭环流程。开发者可借此掌握第三方API的调用方式、密钥管理与鉴权、网络通信处理、错误捕获以及音频文件生成等关键环节。前端界面与后端逻辑分离清晰适合作为PHP网络编程、接口对接的实战学习案例也可直接改造用于自有项目提升产品的信息无障碍与交互体验。1. 在线文字转语音扩展包PHP源码里最值得先读的百度API部分当你拿到一个“PHP在线文字转语音合成源码 基于百度API开发.zip”这类压缩包第一感觉通常是里面有一个后台界面、一个输入框、一个播放按钮。真正决定这套源码能不能上线的却是它怎么处理百度API的鉴权、怎么接收音频流、遇到错误怎么回退。做内容站的人需要把文章转成音频做小工具站的人需要批量生成语音运营同学还想在后台看到合成记录这些需求都会落在同一个根上PHP与百度API之间的那几次请求。这篇文字从“拿到一个TTS源码后该怎么改”的角度把鉴权、参数、文件处理、并发和部署这几个环节拆开讲。刚接触PHP的能把代码抄回去跑通写过几年后台的也能在边界条件和错误处理上少走点弯路。2. 百度API鉴权与合成参数PHP代码影响最大的三件事2.1 先弄清楚一次合成请求涉及哪几步百度语音合成可以简单理解成一个REST接口客户端把文字和参数通过POST或GET发过去服务端返回一段音频也可能返回一段错误JSON。PHP在线TTS源码做得是否健壮就看它有没有把这两类返回区分开。完整链路通常分两步用百度云控制台里创建的API Key和Secret Key换取Access Token把Access Token随合成参数一起发给语音合成的HTTP接口拿到MP3或PCM数据。token的有效期一般有几十天但每次请求都重新换取没必要。源码里如果每次合成前都重新get_token就会出现两个隐患一是多了一次网络往返页面响应慢二是并发高时可能触发频率限制。第4章会讲怎么缓存。这里先记住一个结论百度API对你项目的影响不在“能不能调通”而在“token怎么存、错误怎么判”。下面用表格把鉴权环节最关键的信息列出来配置项你在百度控制台拿到的内容PHP源码里的常规处理API Key应用创建后的Client ID存在config文件或环境变量里Secret Key应用创建后的Client Secret存在服务端配置里不要暴露给前端Access Token用上面两项换取的临时票据缓存后复用减少鉴权请求合成接口地址百度语音合成REST地址用cURL发请求不使用file_get_contents2.2 合成参数里最容易影响PHP代码设计的是aue和per调用百度API合成时tex是文字tok是tokencuid通常写应用标志。比较少被讲清楚的是aue和per这两个参数。aue控制输出格式常见值3表示MP34表示PCM。源码里如果只做页面播放MP3就够了但如果你想在音频后面拼接片头、做音量归一化PCM或WAV处理起来更方便转码时会少一道有损解码。per是人声选项常见0、1、3、4等。这个参数不改变代码结构但影响用户观感。有一个容易踩的坑per和aue并不完全独立在某些账号权限下部分音色只支持特定格式代码里如果硬编码aue3用户选了不支持的音色接口返回错误时页面上却只显示“合成失败”看不出原因。所以健壮的源码在发起请求前会先把参数范围做服务端校验。给一个便于排查参数字段的对照参数含义我习惯的设定tex要合成的文字先trim再校验长度spd语速0-155或6pit音调0-155vol音量0-155后台可调per音色编号0女声1男声3度逍遥4度丫丫aue音频格式3MP34PCMctp客户端类型固定1按百度文档要求填lan语言zh中文合成tok访问凭证从缓存中读取不存在则重新获取提示token获取接口与合成接口的鉴权方式不同合成接口通过表单字段tok传入不是放在HTTP Authorization头里。2.3 为什么PHP源码的重点是“先看返回内容再决定写文件”很多人在第一次写百度语音合成PHP代码时直接把curl_exec()返回值写入文件。这在合成成功时没问题接口返回的二进制头部正好是音频的魔数比如MP3以ID3或0xFF开始。一旦文字过长、文字里有特殊符号、token过期接口会返回一个很小的JSON字符串例如{err_no:3301,err_msg:Access token invalid or no longer valid,sn:...}如果源码不做类型判断就会生成一个几十字节的“音频文件”浏览器播放自然失败。正确的做法是先在PHP侧判断响应最前面的字符是不是{或者直接读取响应的Content-Type。常见做法是下面这样$response curl_exec($ch); $contentType curl_getinfo($ch, CURLINFO_CONTENT_TYPE); if (strpos($contentType, application/json) ! false) { $error json_decode($response, true); throw new RuntimeException(合成失败错误码 . $error[err_no] . 信息 . $error[err_msg]); } file_put_contents($savePath, $response);这里先用curl_getinfo拿到Content-Type。百度API对错误返回固定给JSON所以一旦是JSON就直接进入异常处理不会污染音频目录。这样设计之后源码就同时具备了正确写入音频、以及把失败原因透出到日志或页面两个能力。第3章就按照这个思路写一套最小可用的PHP实现。3. 用PHP写文字转语音请求从token到MP3落盘的实现3.1 封装一个token获取函数不管源码界面有多花哨核心永远是token。下面这段代码可以直接放到类里也可以当作单文件脚本用function getAccessToken(string $apiKey, string $secretKey): string { $url https://aip.baidubce.com/oauth/2.0/token; $postData [ grant_type client_credentials, client_id $apiKey, client_secret $secretKey, ]; $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_POST true, CURLOPT_POSTFIELDS http_build_query($postData), CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT 10, ]); $response curl_exec($ch); $httpCode curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode ! 200 || $response false) { throw new RuntimeException(获取access_token失败HTTP状态码 . $httpCode); } $data json_decode($response, true); if (!isset($data[access_token])) { throw new RuntimeException(获取access_token返回异常 . $response); } return $data[access_token]; }这个函数要做的事情很直接用百度OAuth接口的client_credentials模式换取token。grant_type是OAuth标准参数client_id对应API Keyclient_secret对应Secret Key。我在返回时只保留access_token把expires_in留给调用方缓存层判断。需要留意的是有些老代码会用CURLOPT_HTTPHEADER把token放在header里那是另一个接口的写法语音合成接口的token是通过POST字段或query参数传递的不要混用。3.2 合成接口的PHP调用与音频保存拿到token后下一步是调语音合成接口。这里一般用POST参数直接用表单格式。代码里我会把保存路径设计成调用方传入方便后续做按日期分目录function textToMp3(string $text, string $token, string $savePath): bool { $url https://tsn.baidu.com/text2audio; $postData [ tex $text, tok $token, cuid php-tts-demo, ctp 1, lan zh, spd 5, pit 5, vol 5, per 0, aue 3, ]; $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_POST true, CURLOPT_POSTFIELDS http_build_query($postData), CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT 30, CURLOPT_HTTPHEADER [Accept: audio/mp3], ]); $response curl_exec($ch); $contentType curl_getinfo($ch, CURLINFO_CONTENT_TYPE); $httpCode curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode ! 200) { throw new RuntimeException(语音合成接口HTTP错误 . $httpCode); } if (strpos($contentType, application/json) ! false || strpos($response, {) 0) { $err json_decode($response, true); throw new RuntimeException(语音合成失败[ . $err[err_no] . ] . $err[err_msg]); } if (file_put_contents($savePath, $response) false) { throw new RuntimeException(音频文件写入失败 . $savePath); } return true; }这段代码的关键点有三个。第一CURLOPT_TIMEOUT设到30秒因为长文本的合成耗时并不稳定超时太短容易误杀。第二判断错误时先看Content-Type再看返回内容首字符双保险。第三file_put_contents前没有做目录检查所以调用方要保证目录存在否则会得到“写入失败”而不是合成错误排错时会多绕一圈。3.3 把两个函数串成一条可复制的调用链在真实项目里我不会把token获取和合成写进一个函数里因为后续要做缓存和日志分开更清晰。调用链一般长这样require_once tts.php; $apiKey getenv(BAIDU_API_KEY); $secretKey getenv(BAIDU_SECRET_KEY); $token getAccessToken($apiKey, $secretKey); $text 欢迎使用PHP在线文字转语音源码这个请求将被保存为MP3文件。; $dir /data/www/tts/audio/ . date(Ymd); if (!is_dir($dir)) { mkdir($dir, 0755, true); } $savePath $dir . / . md5($text . microtime()) . .mp3; textToMp3($text, $token, $savePath); echo 生成成功: {$savePath}\n;这里有两个常见问题。一是直接用环境变量存密钥比写在配置文件里更安全能避免源码包被传到公网仓库时把密钥一起带出去二是用md5($text . microtime())做文件名主要目的是防止同一段文字重复覆盖。如果你希望相同文字只生成一次文件名直接改成md5($text)再把文件写到固定目录就天然实现了内容去重。这段代码执行成功后可以用file命令在服务器上看一下文件类型确认是真实的MP3而不是错误JSON。如果发现生成的文件只有几十字节就回头检查3.3里的错误分支是否生效。很多“源码包”其实只是把demo里的curl结果直接输出到浏览器没有落盘对比一下当前实现能看出设计上的差别。4. PHP源码上线前的改造缓存、队列与目录权限4.1 用文件或Redis缓存token减少重复换取线上环境里每个用户都可能触发合成如果每次都调用token接口百度API控制台会看到每秒请求数被刷上来后端响应也会变慢。缓存方案很成熟把token存到临时目录的JSON文件里设置较短的有效期读取前先判断过期时间。function getCachedToken(string $apiKey, string $secretKey): string { $cacheFile sys_get_temp_dir() . /baidu_token_ . md5($apiKey) . .json; if (is_file($cacheFile)) { $cache json_decode(file_get_contents($cacheFile), true); if ($cache $cache[expire_at] time()) { return $cache[access_token]; } } $token getAccessToken($apiKey, $secretKey); file_put_contents($cacheFile, json_encode([ access_token $token, expire_at time() 70000, ], JSON_UNESCAPED_UNICODE)); return $token; }这里把过期时间定为70000秒比官方默认的有效期短很多原因是保守一点宁可多换几次也不要因为服务器时钟偏差导致token刚存入就被判失效。使用Redis版时做法类似用SETEX写入72000秒。要注意的是如果多台服务器共用同一份token文件缓存会失效Redis是必须项如果单机使用文件缓存完全够还能少一个依赖。4.2 给合成接口加队列防止瞬间并发打满百度语音合成API对并发和QPS有限制。普通页面如果用户快速点击“生成”请求会直接打到百度接口结果是部分请求返回错误码或者HTTP限制。成熟的PHP源码一般会在textToMp3()外面包一层任务队列先生成任务再由后台进程依次消费。队列最简单的实现是用数据库表CREATE TABLE tts_task ( id INT AUTO_INCREMENT PRIMARY KEY, text_content TEXT NOT NULL, file_path VARCHAR(255) DEFAULT , status TINYINT DEFAULT 0, error_msg VARCHAR(255) DEFAULT , created_at DATETIME DEFAULT CURRENT_TIMESTAMP );消费端脚本我一般会在CLI模式下跑一个常驻进程每5秒查一次待处理记录while (true) { $task $pdo-query(SELECT * FROM tts_task WHERE status0 ORDER BY id ASC LIMIT 1)-fetch(); if ($task) { try { textToMp3($task[text_content], getCachedToken($apiKey, $secretKey), $savePath); $pdo-prepare(UPDATE tts_task SET status1, file_path? WHERE id?)-execute([$savePath, $task[id]]); } catch (Exception $e) { $pdo-prepare(UPDATE tts_task SET status2, error_msg? WHERE id?)-execute([$e-getMessage(), $task[id]]); } } else { sleep(5); } }如果不想引入数据库可以用Redis ListLPUSH入队BRPOP出队。哪个更合适取决于项目现状已有Redis就直接用队列没有的话MySQL更省事。加入队列后还要设置一个最大重试次数。以我的经验合成失败很少因为百度接口本身更多来自token过期和超长文本。所以error_msg字段里除了错误码还建议存下本次请求的tex长度方便后续看出是哪些文字太长。4.3 音频目录权限与Nginx配置的四个坑把源码部署到NginxPHP-FPM环境时音频目录通常是冲突高发区。有四个点我建议直接检查隐患表现解决办法音频目录不可写合成成功但保存失败chown www-data:www-data -R /data/www/tts/audio目录可执行PHP用户上传或生成异常文件时可被解析在Nginx location中排除audio目录的PHP解析文件权限过大其他用户可遍历音频列表外层目录设为0711音频文件设为0644播放路径暴露真实文件名容易被人直接刷接口文件名用随机串不直接带自增IDNginx里加一段就能避免audio目录被当成PHP执行location ^~ /tts/audio/ { expires 30d; add_header Cache-Control public, no-transform; }这段配置里没有FastCGI配置所以任何以/tts/audio/开头的请求都会直接返回静态文件。顺便设置一个30天的缓存过期时间浏览器第二次播放同样音频时就不会再回源到PHP。若源码里音频是动态输出的另一种做法是请求/tts.php?filexxx但那样每次播放都占用一个PHP进程在高并发下得不偿失。线上我优先推荐生成真实MP3文件再让Nginx直接serve。5. 进阶小技巧命令行验证合成链路、安全播放与长文本分批5.1 用PHP CLI做一次端到端验证源码改完后不需要先打开浏览器直接在服务器上用CLI脚本跑通最小链路更高效。把第3章代码存成cli_tts.php然后执行php cli_tts.php脚本结束后用以下命令确认文件类型file /data/www/tts/audio/20250101/*.mp3输出应该包含MPEG ADTS, layer III之类的描述。如果输出是ASCII text说明保存的还是JSON错误信息此时直接查看文件内容就能看到err_msg。这个验证方式比在后台界面上等提示更直接因为CLI脚本会把PHP警告全部打印到终端不容易被框架拦截。5.2 前端播放时如何不暴露百度API密钥在线文字转语音源码的使用场景通常是后台管理员操作但有时也要开放给普通用户使用。此时不能把token、API Key直接放在页面里。常见做法是合成请求经过会话权限校验后返回一个短期有效的音频URL比如/tts/audio/{date}/{random}.mp3。文件下载和播放交给Nginx密钥只存在于服务端配置或环境变量中。如果需要给同一段文字生成多个音色前端可以用audio标签播放audio controls preloadnone src/tts/audio/20250101/a1b2c3d4.mp3/audio如果担心文件被直接遍历更推荐的做法是让Nginx加签名参数校验。对大多数PHP项目来说最简单的做法是把音频文件名设成UUID并放在不可索引目录然后在PHP里用readfile()输出代价是每次播放都会多占一个PHP进程。一句话能静态化就静态化必须动态输出时加鉴权不要裸奔。5.3 长文本拆分的具体粒度百度API的单次合成文本长度有上限超长后接口会直接报错。源码包里如果只做了一段textarea提交遇到几千字文章就会踩到。常见的做法是按标点切分把文章拆成句子数组再批量调用。给一个简单的拆分参考$parts preg_split(/(?[。])/, $text, -1, PREG_SPLIT_NO_EMPTY);每次合成的文本控制在200个中文字符以内既能保证音色自然也能让失败重试的定位更精确。把每段结果文件名保存在数组里最后再通过一个播放列表把多段音频连起来播放。接口没有直接拼接多段MP3的能力所以前端播放器要支持播放列表或者服务端用FFmpeg把多段音频再合成一个文件。后者会多一步转码时间前者实现起来更轻。我一般会选择前端播放列表并为每段音频记录生成时间和文本哈希方便排查是哪一段触发错误码。如果需要合并成单个MP3可以用FFmpeg的concat方式ffmpeg -f concat -safe 0 -i list.txt -c copy out.mp3list.txt里按顺序写入file /data/www/tts/audio/part1.mp3这样的路径。合并时注意所有段必须是同一种采样率和声道数否则直接用-c copy会出现时间偏移。先查一下每段音频的编码参数不一致就在合并前统一转成相同规格再执行上面的命令。以上就是从拿到“PHP在线文字转语音合成源码”到真正能够上线使用的完整路径先确认百度API的鉴权与参数再把请求和处理返回封装成可复用PHP代码上线前补上缓存、队列和目录权限最后用命令行和播放列表把链路验证完整。顺着这条路径去检查手头源码的每个缺口比直接点开浏览器里的“开始合成”按钮要高效得多。本文还有配套的精品资源点击获取