PHP 实现的微博图床上传轮子
安装
要求
- PHP 5.5.9 以上版本
- json 扩展
- openssl 扩展
使用 composer (推荐)
composer require consatan/weibo_image_uploader:~0.5
从 Github 上下载
git clone https://consatan.github.com/weibo_image_uploader.git
cd weibo_image_upload
git checkout 0.5
使用示例
<?php
// 引入 composer autoload
require './vendor/autoload.php';
$weibo = new Consatan\Weibo\ImageUploader\Client();
// 默认返回的是 https 协议的图床 URL，调用该方法返回的是 http 协议的图床 URL
// $weibo->useHttps(false);
// 上传示例图片
$url = $weibo->upload('./example.jpg', '微博帐号', '微博帐号密码');
// 输出新浪图床 URL
echo $url . PHP_EOL;
使用说明
构造函数可传递 \Psr\Cache\CacheItemPoolInterface 和 \GuzzleHttp\ClientInterface，默认情况下使用文件缓存 cookie 信息，存储在项目根目录的 cache/weibo 文件夹下，缓存的 key 使用 md5 后的微博用户名，可根据需求将缓存保存到其他适配器中，具体参见 \Symfony\Cache\Adapter。
Client::upload 方法的第四个参数允许传递 Guzzle request 的参数数组，具体见 Request Options，通过该参数可实现切换代理等操作，如下例：
<?php
// 文件路径
$url1 = $weibo->upload('./example.jpg', '微博帐号1', '密码');
// 同一用户名只有第一次上传需要登入，之后使用缓存的登入 cookie 进行上传
// 如果使用 cookie 上传失败，将尝试重新登入一次，还是失败的话抛出异常
// 除非使用的是无法持久化保存的缓存适配器(如 ArrayAdapter)
// 否则以后同一用户名都将使用缓存的 cookie 进行登入
// echo $weibo->upload('./example.jpg', '微博帐号1', '密码');
// resource
$url2 = $weibo->upload(fopen('./example.jpg', 'r'), '微博帐号2', '密码', [
'proxy' => 'http://192.168.1.100:8080'
]);
// 字符串
$url3 = $weibo->upload(file_get_contents('./example.jpg'), '微博帐号3', '密码', [
'proxy' => 'http://192.168.1.200:8090'
]);
// \Psr\Http\Message\StreamInterface
$url4 = $weibo->upload(\GuzzleHttp\Psr7\stream_for(file_get_contents('./example.jpg')), '微博帐号4', '密码', [
'proxy' => 'http://192.168.1.250:9080'
]);
抛出的所有异常都可通过 \Consatan\Weibo\ImageUploader\Exception\ImageUploaderException 接口捕获， 实现该接口的异常都在 src/Exception 目录下
Todo
- 单元测试
- 获取其他规格的图片 URL（如，small, thumbnail...）
- 添加水印选项