正如上面所述，本文将介绍如何使用 PHP 从客户端设备直接上传视频到 Vimeo。通常，Vimeo API 的上传方式需要先将视频上传到服务器，然后再从服务器上传到 Vimeo。但 Vimeo 提供了表单上传的方式，允许客户端直接将视频上传到 Vimeo，从而减少服务器的压力，提升用户体验。
实现步骤
以下是使用 PHP 实现从客户端设备直接上传视频到 Vimeo 的步骤：
-
获取上传 URL 和表单数据：
首先，需要通过 Vimeo API 获取用于上传视频的 URL 和表单数据。可以使用 PHP SDK 的 request 方法，向 /me/videos 端点发送 POST 请求，并指定 upload 参数。
立即学习“PHP免费学习笔记（深入）”；
require 'vendor/autoload.php'; // 引入 Composer 自动加载 $client_id = '{your_client_id}'; $client_secret = '{your_client_secret}'; $access_token = '{your_access_token}'; $lib = new Vimeo\Vimeo($client_id, $client_secret, $access_token); $response = $lib->request('/me/videos', [ "upload" => [ "approach" => "post", "redirect_url" => "{url}" // 上传完成后重定向的 URL ] ], 'POST'); if ($response['status'] == 200) { $upload_url = $response['body']['upload']['upload_link']; $form = $response['body']['upload']['form']; $video_uri = $response['body']['uri']; // 新创建的视频的 URI } else { // 处理错误 echo "Error: " . $response['status'] . " - " . $response['body']['error']; exit; }注意: 请替换 {your_client_id}、{your_client_secret} 和 {your_access_token} 为你自己的 Vimeo API 凭证。 {url} 替换为上传完成后希望重定向的 URL。
-
生成 HTML 表单：
$form 变量包含了 HTML 表单的代码。可以将这段代码嵌入到你的网页中，供用户选择视频文件并上传。
echo $form; // 输出 HTML 表单
通常，你需要对这个表单进行一些调整，例如添加文件选择控件，设置表单的 enctype 属性为 multipart/form-data，并设置表单的 action 属性为 $upload_url。
一个简单的 HTML 表单示例：
<form action="<?php echo $upload_url; ?>" method="post" enctype="multipart/form-data"> <input type="file" name="file" id="videoFile"> <input type="hidden" name="signature" value="<?php echo htmlspecialchars($response['body']['upload']['signature']); ?>"> <input type="hidden" name="algorithm" value="<?php echo htmlspecialchars($response['body']['upload']['algorithm']); ?>"> <button type="submit">上传视频</button> </form>
注意: signature 和 algorithm 字段也需要从 $response['body']['upload'] 中获取，并添加到表单中。 使用 htmlspecialchars 对这些值进行转义，以防止 XSS 攻击。
-
处理上传完成后的重定向：
当视频上传完成后，Vimeo 会将用户重定向到你在第一步中指定的 redirect_url。你可以在这个页面上处理上传结果，例如显示上传成功的消息，或者将视频的 URI ($video_uri) 存储到数据库中。
// 在 redirect_url 页面上 if (isset($_GET['video_uri'])) { $video_uri = $_GET['video_uri']; echo "视频上传成功！视频 URI: " . $video_uri; // 将 $video_uri 存储到数据库中 // ... } else { // 处理上传失败的情况 echo "视频上传失败！"; }注意: Vimeo 会将视频的 URI 作为 video_uri 参数添加到 redirect_url 中。
示例代码
以下是一个完整的示例代码，展示了如何使用 PHP 从客户端设备直接上传视频到 Vimeo：
<?php
require 'vendor/autoload.php'; // 引入 Composer 自动加载
$client_id = '{your_client_id}';
$client_secret = '{your_client_secret}';
$access_token = '{your_access_token}';
$redirect_url = 'https://example.com/upload-complete'; // 上传完成后重定向的 URL
$lib = new Vimeo\Vimeo($client_id, $client_secret, $access_token);
$response = $lib->request('/me/videos', [
"upload" => [
"approach" => "post",
"redirect_url" => $redirect_url
]
], 'POST');
if ($response['status'] == 200) {
$upload_url = $response['body']['upload']['upload_link'];
$form = $response['body']['upload']['form'];
$video_uri = $response['body']['uri']; // 新创建的视频的 URI
} else {
// 处理错误
echo "Error: " . $response['status'] . " - " . $response['body']['error'];
exit;
}
?>
<!DOCTYPE html>
<html>
<head>
<title>Vimeo Video Upload</title>
</head>
<body>
<h1>上传视频到 Vimeo</h1>
<form action="<?php echo $upload_url; ?>" method="post" enctype="multipart/form-data">
<input type="file" name="file" id="videoFile">
<input type="hidden" name="signature" value="<?php echo htmlspecialchars($response['body']['upload']['signature']); ?>">
<input type="hidden" name="algorithm" value="<?php echo htmlspecialchars($response['body']['upload']['algorithm']); ?>">
<button type="submit">上传视频</button>
</form>
</body>
</html>注意: 请确保已经安装了 Vimeo PHP SDK，可以使用 Composer 进行安装：composer require vimeo/vimeo-api
注意事项
- API 凭证安全: 务必妥善保管你的 Vimeo API 凭证，不要将它们暴露在客户端代码中。
- 错误处理: 在代码中添加适当的错误处理机制，以便在上传过程中出现问题时能够及时发现并处理。
- 文件大小限制: Vimeo 对上传的视频文件大小有限制，请确保上传的文件不超过限制。
- 重定向 URL 安全: 确保你的 redirect_url 是安全的，防止恶意用户篡改。
- 跨域问题: 如果你的网站和 Vimeo API 位于不同的域名下，需要处理跨域问题。
- 用户体验: 提供清晰的上传进度指示，并告知用户上传结果。
总结
通过本文档，你应该能够了解如何使用 PHP 从客户端设备直接上传视频到 Vimeo。这种方式可以有效地减少服务器的压力，提升用户体验。请务必仔细阅读本文档，并根据你的实际情况进行调整。
