How to install and use the Intelligent Media Management PHP SDK-Intelligent Media Management(IMM)-阿里云帮助中心

Alibaba Cloud OpenAPI Explorer provides API documentation, API debugging, and SDK examples to help you get started with API development. This topic describes how to install and use Intelligent Media Management (IMM) SDK for PHP.

Prerequisites

You have created an AccessKey pair. For more information, see Create an AccessKey pair.
You have activated OSS, created a bucket, and uploaded files to the bucket. For more information, see Upload files.
You have activated IMM. For more information, see Activate IMM.
A project is created in the IMM console. For more information about how to create a project by using the IMM console, see Create a project.
Note
- You can also create a project by calling the CreateProject operation. For more information, see CreateProject.
- You can call the ListProjects operation to query existing projects in a specific region. For more information, see ListProjects.

Install the SDK

Important

To call API operations of version 2020-09-30, you must use the SDK for version 2020-09-30.

For more information about how to use IMM SDK for PHP, see Quick Start.

Install Composer

Download the composer-setup.php setup file to the current directory.

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
Run the installation procedure.

php composer-setup.php
Delete the setup file.

php -r "unlink('composer-setup.php');"
Run the sudo mv composer.phar /usr/local/bin/composer command to install Composer globally. After the installation is complete, the composer.phar file is created. Open the php composer.phar file to use Composer.

Install IMM dependencies

Run the composer require alibabacloud/imm-20200930 4.4.0 command.

Access credentials

The following types of access credentials are supported:

Temporary access credentials: In scenarios where high security is critical, such as temporary authorization of access to IMM, we recommend that you use temporary access credentials. Temporary access credentials are valid within the specified period of time, which helps prevent credential leaks. Temporary access credentials support fine-grained access control, which prevents security risks caused by excessive permissions.
Long-term access credentials: To ensure data security, we recommend that you do not use long-term access credentials. For scenarios that require convenience, long-term access credentials eliminate the need for multiple refreshes within a long period of time. We recommend that you change your long-term access credentials every three months to ensure account security. If long-term access credentials are leaked or no longer used, you can delete or disable the long-term access credentials to reduce security risks.

Use temporary access credentials

For more information about how to configure access credentials for temporary access to IMM using IMM SDK for PHP, see Configure environment variables to store temporary access credentials.

The following example shows how to use temporary access credentials and the IMM SDK for PHP to detect faces in an image. The example uses the China (Hangzhou) region.

Note

To obtain an STS TOKEN with temporary access credentials, you must install additional dependencies:

composer require alibabacloud/sts-20150401 1.1.4

Create the demo.php file and write the following content to the file:

<?php

// This file is auto-generated, don't edit it. Thanks.
namespace AlibabaCloud\SDK\Sample;

use AlibabaCloud\SDK\Sts\V20150401\Sts;
use AlibabaCloud\Tea\Utils\Utils;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;

use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Sts\V20150401\Models\AssumeRoleRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

use AlibabaCloud\SDK\Imm\V20200930\Imm;
use AlibabaCloud\SDK\Imm\V20200930\Models\DetectImageFacesRequest;


class Sample {
       /**
     * Use your AccessKey ID and AccessKey secret to initialize the client.
     * @return imm Client
     */
    public static function createClient(){
        // If the project code is leaked, the AccessKey pair may be leaked and the security of all resources within your account may be compromised. The following lines are provided for reference only. 
        // For security reasons, we recommend that you use temporary access credentials that are provided by Security Token Service (STS). For more information, visit https://www.alibabacloud.com/help/en/sdk/developer-reference/v2-manage-php-access-credentials. 
        $stsConfig = new Config([
            // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured. 
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured. 
            "accessKeySecret" => getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
        ]);
        // Specify the endpoint. For more information, visit https://api.aliyun.com/product/Sts.
        $stsConfig->endpoint = "sts.cn-hangzhou.aliyuncs.com";
        $stsClient = new Sts($stsConfig);
        $assumeRoleRequest = new AssumeRoleRequest([
            // Specify the ARN of the RAM role to be assumed. Example: acs:ram::123456789012****:role/adminrole
            "roleArn" => "acs:ram::125499367423****:role/STStokenTestRole",
            // Specify the name of the role session.
            "roleSessionName" => "ststest",
            // Specify the valid period of access credentials. Unit: seconds.
            "durationSeconds" => 3600
        ]);
        $runtime = new RuntimeOptions([]);
        $resp = $stsClient->assumeRoleWithOptions($assumeRoleRequest, $runtime);
        $config = new Config([
            "accessKeyId" => $resp->body->credentials->accessKeyId,
            "accessKeySecret" => $resp->body->credentials->accessKeySecret,
            "securityToken" => $resp->body->credentials->securityToken
        ]);
        // For a list of IMM endpoints for supported regions, visit https://api.alibabacloud.com/product/imm.
        $config->endpoint = "imm.cn-hangzhou.aliyuncs.com";
        return new Imm($config);
    }

    /**
     * @param string[] $args
     * @return void
     */
    public static function main($args){
        $client = self::createClient();
        $detectImageFacesRequest = new DetectImageFacesRequest([
            "projectName" => "imm-php-sdk-doc-demo",
            "sourceURI" => "oss://your-bucket-name/your-path/your-image.jpg"
        ]);
        $runtime = new RuntimeOptions([]);
        try {
            // Write your code to print the response of the API operation if necessary.
           print_r($client->detectImageFacesWithOptions($detectImageFacesRequest, $runtime));
        }
        catch (Exception $error) {
            if (!($error instanceof TeaError)) {
                $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
            }
            // In this example, errors are printed. In your actual project, process errors as needed. 
            // Display error messages.
            var_dump($error->message);
            // Display the URL for troubleshooting.
            var_dump($error->data["Recommend"]);
            Utils::assertAsString($error->message);
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
Sample::main(array_slice($argv, 1));

Run the php demo.php command. The output is similar to the following content:

Use long-term access credentials

If you want to temporarily use the PHP SDK to access the IMM service, refer to Configure long-term access credentials.

The following example shows how to use long-term access credentials and the IMM SDK for PHP to detect faces in an image. The example uses the China (Hangzhou) region.

Create the demo.php file and write the following content to the file:

<?php

// This file is auto-generated, don't edit it. Thanks.
namespace AlibabaCloud\SDK\Sample;

use AlibabaCloud\SDK\Imm\V20200930\Imm;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;
use AlibabaCloud\Tea\Utils\Utils;

use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Imm\V20200930\Models\DetectImageFacesRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

class Sample {

    /**
     * Use your AccessKey ID and AccessKey secret to initialize the client.
     * @return Imm Client
     */
    public static function createClient(){
        // If the project code is leaked, the AccessKey pair may be leaked and the security of all resources within your account may be compromised. The following lines are provided for reference only. 
        // For security reasons, we recommend that you use temporary access credentials that are provided by STS. For more information, visit https://www.alibabacloud.com/help/en/sdk/developer-reference/v2-manage-php-access-credentials. 
        $config = new Config([
            // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured. 
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured. 
            "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        ]);
        // For a list of IMM endpoints for supported regions, visit https://api.alibabacloud.com/product/imm.
        $config->endpoint = "imm.cn-beijing.aliyuncs.com";
        return new Imm($config);
    }

    /**
     * @param string[] $args
     * @return void
     */
    public static function main($args){
        $client = self::createClient();
        $detectImageFacesRequest = new DetectImageFacesRequest([
            "projectName" => "imm-php-sdk-doc-demo",
            "sourceURI" => "oss://your-bucket-name/your-path/your-image.jpg"
        ]);
        $runtime = new RuntimeOptions([]);
        try {
            // Write your code to print the response of the API operation if necessary.
           print_r($client->detectImageFacesWithOptions($detectImageFacesRequest, $runtime));
        }
        catch (Exception $error) {
            if (!($error instanceof TeaError)) {
                $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
            }
            // In this example, errors are printed. In your actual project, process errors as needed. 
            // Display error messages.
            var_dump($error->message);
            // Display the URL for troubleshooting.
            var_dump($error->data["Recommend"]);
            Utils::assertAsString($error->message);
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
Sample::main(array_slice($argv, 1));

Run the php demo.php command. The output is similar to the following content:

Array
(
    [Faces] => Array
        (
            [0] => Array
                (
                    [Age] => 12
                    [AgeSD] => 5
                    [Attractive] => 0.12099999934435
                    [Beard] => none
                    [BeardConfidence] => 0.99800002574921
                    [Boundary] => Array
                        (
                            [Height] => 87
                            [Left] => 280
                            [Top] => 36
                            [Width] => 70
                        )
                    [Emotion] => none
                    [EmotionConfidence] => 0.99500000476837
                    [FaceQuality] => 0.8289999961853
                    [FigureClusterId] => figure-cluster-id-unavailable
                    [FigureConfidence] => 0.9990000128746
                    [FigureId] => 3acab8ff-48e7-4647-ac57-b48834db7278
                    [FigureType] => face
                    [Gender] => male
                    [GenderConfidence] => 0.95099997520447
                    [Glasses] => none
                    [GlassesConfidence] => 1
                    [Hat] => hat
                    [HatConfidence] => 0.9879999756813
                    [HeadPose] => Array
                        (
                            [Pitch] => -12.309000015259
                            [Roll] => -11.362000465393
                            [Yaw] => 3.4430000782013
                        )
                    [Mask] => none
                    [MaskConfidence] => 0.7509999871254
                    [Mouth] => open
                    [MouthConfidence] => 0.56699997186661
                    [Sharpness] => 0.8870000243187
                )
        )
    [RequestId] => F6D3FE7E-F0D7-0A5B-AE34-7453991DF9F2
)