README

GoogleVisionApiBundle 是一个用于简单使用 Google Vision API 的 Symfony2/3 Bundle (https://cloud.google.com/vision/)

安装

通过 Composer

$ composer require headoo/google-vision-api-bundle

或在 composer.json 文件中

"headoo/google-vision-api-bundle": "dev-master"

在 app/AppKernel.php 中注册该包

public function registerBundles()
{
    return array(
        // ...
        new Headoo\GoogleVisionApiBundle\HeadooGoogleVisionApiBundle(),
        // ...
    );
}

配置

在您的 config.yml 中配置 Google API 密钥

headoo_google_vision_api:
    api_key: '%apikey%'

用法

它就像一个服务一样工作。在一个控制器中，您可以这样调用

	$google_vision = $this->container->get('headoo_google_vision_api.helper');

您可以使用一个端点使用所有检测功能

	$google_vision->vision($image, $type);

您的 $image 必须是 base64 编码的，或通过 URL，或绝对路径。

可用的 $type 有

• TYPE_UNSPECIFIED
• FACE_DETECTION
• LANDMARK_DETECTION
• LOGO_DETECTION
• LABEL_DETECTION
• TEXT_DETECTION
• SAFE_SEARCH_DETECTION
• IMAGE_PROPERTIES
• WEB_DETECTION

返回结果

您将收到一个包含 http_code、raw_response 和 parsed_response 的数组。

• http_code : Google Http 响应代码（通常是 200 表示成功，400 表示错误）
• raw_response : Google Vision Api 原始响应，未经处理
• parsed_response : 带有对象的解析响应，更容易供 PHP 用户使用。

安全性

如果您发现安全漏洞，请通过电子邮件报告，而不是使用问题跟踪器。所有安全漏洞都将得到及时解决。

独立测试

如何测试

1. 克隆仓库：$ sudo git clone https://github.com/Headoo/GoogleVisionApiBundle.git
2. 进入目录：$ cd GoogleVisionApiBundle/
3. 安装 composer，方法如下：https://getcomposer.org.cn/download/
4. 运行 composer update：$ ./composer.phar update
5. 在 Tests/App/config.yml 中修改 headoo_google_vision_api.api_key
6. 运行测试：$ ./vendor/phpunit/phpunit/phpunit

许可证

此包是开源软件，受 MIT 许可证的许可