快速开始

更新时间:

本文为您介绍如何安装PHP环境并提供安装步骤、示例代码及API使用方法,帮助您快速上手构建云服务,实现API调用和服务集成。

环境准备

环境要求

  • 已下载并安装PHP 5.6或以上版本。PHP下载地址

  • 必须在系统上全局安装 Composer

  • 已下载并安装开发者工具,本文以PhpStorm为例。PhpStorm下载地址

  • 已创建AccessKey。在调用阿里云API时您需要使用AccessKey完成身份验证。AccessKey包括AccessKey ID和AccessKey Secret。关于如何创建和获取AccessKey,请参见创建AccessKey

验证版本

打开终端,输入php -v,查看PHP版本。

运行示例代码

步骤一:下载SDK完整工程

  1. 登录OpenAPI 门户

  2. 在顶部导航栏,单击选择云产品,在弹出面板中根据需要选择云产品。

    image

  3. 在云产品OpenAPI 主页,点击右上角去调试(图1),会弹出OpenAPI 调试页面(图2)。

    图1

    image

    图2

    image.png

  4. 左侧分栏选择您需要使用的接口,中间分栏填入接口需要的参数,右侧分栏选择SDK示例页签。

  5. 选择SDK版本V2.0,选择所使用的语言。

    说明

    部分产品可能不支持选择SDK版本。请在步骤3的图1中查看云产品支持的SDK版本。

  6. 单击下载完整工程按钮,下载示例代码。

  7. 如果想要生成泛化调用代码,请勾选Common模式生成示例。更多信息请参见泛化调用与特化调用

步骤二:配置环境变量

配置环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。

重要

环境变量配置完成之后,需要重启您的所使用的开发工具(若不重启可能会无法正常读取环境变量)。

  • Linux和macOS系统配置方法

    1. 创建.bash_profile文件

      说明

      如果是第一次设置环境变量,可以使用touch ~/.bash_profile创建一个配置文件,如果已经存在配置文件,则使用vim ~/.bash_profile命令直接编辑文件。

      touch ~/.bash_profile
      vim ~/.bash_profile
    2. 配置.bash_profile文件

      # 将以下命令中的<ACCESS_KEY_ID>和<ACCESS_KEY_SECRET>替换为您自己的AccessKey ID和AccessKey Secret。
      # 变量名称可以根据实际情况进行替换,例如OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET。
      export ALIBABA_CLOUD_ACCESS_KEY_ID=<ACCESS_KEY_ID>
      export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<ACCESS_KEY_SECRET>

      编辑完成后保存退出。

    3. 使用.bash_profile文件

      # 使配置文件生效
      source ~/.bash_profile
      # 显示配置是否生效
      echo $ALIBABA_CLOUD_ACCESS_KEY_ID

      若返回正确的AccessKey ID,则说明配置成功。

  • Windows系统配置方法

    通过图形用户界面GUI

    • 操作步骤

      以下为Windows 10中通过图形用户界面设置环境变量的步骤。

      在桌面右键单击此电脑,选择属性>高级系统设置>环境变量>系统变量/用户变量>新建,完成以下配置:

      变量

      示例值

      AccessKey ID

      • 变量名:ALIBABA_CLOUD_ACCESS_KEY_ID

      • 变量值:LTAI4GDty8ab9W4Y1D****

      AccessKey Secret

      • 变量名:ALIBABA_CLOUD_ACCESS_KEY_SECRET

      • 变量值:IrVTNZNy5yQelTETg0cZML3TQn****

    • 测试设置是否成功

      单击开始(或快捷键:Win+R)> 运行(输入 cmd)> 确定(或按 Enter 键),打开命令提示符,执行echo %ALIBABA_CLOUD_ACCESS_KEY_ID%echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%命令。若返回正确的AccessKey,则说明配置成功。

    通过命令行提示符CMD

    • 操作步骤

      以管理员身份打开命令提示符,并使用以下命令在系统中新增环境变量。

      setx ALIBABA_CLOUD_ACCESS_KEY_ID LTAI4GDty8ab9W4Y1D**** /M
      setx ALIBABA_CLOUD_ACCESS_KEY_SECRET IrVTNZNy5yQelTETg0cZML3TQn**** /M

      其中/M表示系统级环境变量,设置用户级环境变量时可以不携带该参数。

    • 测试设置是否成功

      单击开始(或快捷键:Win+R)> 运行(输入 cmd)> 确定(或按 Enter 键),打开命令提示符,执行echo %ALIBABA_CLOUD_ACCESS_KEY_ID%echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%命令。若返回正确的AccessKey,则说明配置成功。

    通过Windows PowerShell

    在PowerShell中,设置新的环境变量(对所有新会话都有效):

    [System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::User)
    [System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::User)

    为所有用户设置环境变量(需要管理员权限):

    [System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::Machine)
    [System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::Machine)

    设置临时的环境变量(仅当前会话有效):

    $env:ALIBABA_CLOUD_ACCESS_KEY_ID = "LTAI4GDty8ab9W4Y1D****"
    $env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "IrVTNZNy5yQelTETg0cZML3TQn****"

    在PowerShell中,执行Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_IDGet-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET命令。若返回正确的AccessKey,则说明配置成功。

步骤三:运行代码

  1. 在PhpStorm中运行代码,查看终端返回的相关信息和requestId

  2. 如果调用的是创建实例的接口,还会返回实例ID,您可以根据返回的实例ID去该产品的控制台验证。