PHP 版 Google Cloud 客户端库是一个用于访问 Google Cloud 服务的客户端库,可减少您必须编写的样板代码。该库提供易于理解的高级 API 抽象。它接受 PHP 的习语,与标准库良好适配,并且与您的代码库更紧密地集成。所有这些特点意味着您可以有更多的时间创建对您来说真正重要的代码。
在本地安装库:
composer require google/cloud
借助 Google Cloud CLI,您可以在本地处理身份验证。如果您希望本地应用临时使用您自己的用户凭据进行 API 访问,请运行以下命令:
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-04。"],[[["\u003cp\u003eComposer manages PHP dependencies in App Engine, automatically installing them upon deployment from a \u003ccode\u003ecomposer.json\u003c/code\u003e file located in your application's root directory.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003evendor/\u003c/code\u003e directory, where Composer installs dependencies, is automatically ignored by \u003ccode\u003e.gcloudignore\u003c/code\u003e to optimize deployment file sizes, and an \u003ccode\u003eautoload.php\u003c/code\u003e is created to load these dependencies automatically.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003egcloud app deploy --no-cache\u003c/code\u003e command to deploy uncached versions of dependencies, overriding App Engine's default caching behavior for faster build times.\u003c/p\u003e\n"],["\u003cp\u003eApp Engine supports various PHP web frameworks such as Symfony, Laravel, CodeIgniter, WordPress, Drupal, and Joomla!, and serves requests through \u003ccode\u003epublic/index.php\u003c/code\u003e or \u003ccode\u003eindex.php\u003c/code\u003e by default.\u003c/p\u003e\n"],["\u003cp\u003ePrivate repositories, like those on GitHub or Bitbucket, can be accessed by configuring them in \u003ccode\u003ecomposer.json\u003c/code\u003e and providing authentication credentials in an \u003ccode\u003eauth.json\u003c/code\u003e file.\u003c/p\u003e\n"]]],[],null,["# Specifying dependencies\n\n[Composer](https://getcomposer.org/) runs\nautomatically when you deploy a new version of your application. Simply add the\nfollowing line to the top of your PHP scripts to require the `autoload.php`\nfile: \n\n require_once __DIR__ . '/vendor/autoload.php';\n\nComposer adds the packages to your app's `vendor/` directory, where the\n`autoload.php` file is generated. The Composer autoloader automatically loads\nclasses installed by Composer without a `require` statement for each file.\n\nBy default, the `vendor/` directory is ignored in the generated\n[`.gcloudignore`](/sdk/gcloud/reference/topic/gcloudignore) file to reduce the\nnumber of files sent in deployment.\n\nYou can declare dependencies for PHP in a standard [`composer.json`](https://getcomposer.org/doc/01-basic-usage.md#composer-json-project-setup) file. For example: \n\n {\n \"require\": {\n \"google/cloud\": \"^0.72\"\n }\n }\n\nYou can use any Linux-compatible PHP package in App Engine. The runtime\nlooks for a [`composer.json`](https://getcomposer.org/doc/01-basic-usage.md#composer-json-project-setup) file in your application's source\ndirectory and uses [`composer`](https://getcomposer.org) to install any dependencies before\nstarting your application.\n\nScripts defined in your [`composer.json` file](https://getcomposer.org/doc/articles/scripts.md)\nwill not run when Composer can use a cached result.\n\n\nBy default, App Engine caches fetched dependencies to reduce build\ntimes. To install an uncached version of the dependency, use the command: \n\n gcloud app deploy --no-cache\n\n\u003cbr /\u003e\n\nInstalling and running locally\n------------------------------\n\nUse [composer](https://getcomposer.org) to install your dependencies locally: \n\n composer install\n\nTo pin your dependencies to their current version, commit the [`composer.lock`](https://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file) file to your application.\n\n\u003cbr /\u003e\n\nYou can test your application using your web server of choice. To quickly run your application, you can use\n[PHP's built-in web server](http://php.net/manual/en/features.commandline.webserver.php).\n\n\nInstalling a web framework\n--------------------------\n\nBy default, App Engine serves all requests through the\n`public/index.php` or `index.php` file. A framework is not required, but is\nencouraged. You can use any web framework with App Engine, including the\nfollowing:\n\n- [Symfony](https://symfony.com/)\n- [Laravel](https://laravel.com/)\n- [CodeIgniter](https://www.codeigniter.com/)\n- [WordPress](https://wordpress.com/)\n- [Drupal](https://drupal.com/)\n- [Joomla!](https://www.joomla.com/)\n\nInstalling the Cloud Client Libraries\n-------------------------------------\n\nThe [Google Cloud Client Library for PHP](https://googleapis.github.io/google-cloud-php/#/)\nis a client library for accessing Google Cloud services that\nreduces the boilerplate code you have to write. The library provides high-level,\neasy to understand API abstractions. It embraces idioms of PHP,\nworks well with the standard library, and has tighter integration with your\ncodebase. All of this means you spend more time creating code that matters to\nyou.\n\n1. Install the library locally:\n\n composer require google/cloud\n\n2. You can handle authentication locally by using the [Google Cloud CLI](/sdk/docs).\n If you want your local application to temporarily use your own user credentials\n for API access, run:\n\n gcloud auth application-default login\n\n For details on configuring Cloud Client Libraries for PHP to handle authentication\n automatically, see [Authenticate to Cloud services using client libraries](/docs/authentication/client-libraries).\n\nUsing private repositories\n--------------------------\n\nTo use libraries in private repositories, you must complete the following tasks:\n\n- Configure the repository.\n- Give `composer` the secret to access the private repository.\n\nThe following example illustrates how to access a private repository in GitHub.\n\n1. Configure the repository in `composer.json` using `vcs` for the type:\n\n \"repositories\": [\n {\n \"type\": \"vcs\",\n \"url\": \"https://github.com/username/private_package\"\n }\n ]\n\n2. Create a file named `auth.json` in your project root directory:\n\n {\n \"github-oauth\": {\n \"github.com\": \"\u003cyour-github-auth-token\u003e\"\n }\n }\n\nYou can obtain the GitHub auth token from GitHub's administrative UI.\n\nHere is another example that illustrates how to access a private repository for\nBitbucket.\n\n1. Configure the repository in `composer.json` using `vcs` for the type:\n\n \"repositories\": [\n {\n \"type\": \"vcs\",\n \"url\": \"https://bitbucket.org/username/private_git\"\n }\n ]\n\n2. Create a file named `auth.json` in your project root directory:\n\n {\n \"bitbucket-oauth\": {\n \"bitbucket.org\": {\n \"consumer-key\": \"\u003cyour-oauth-consumer-key\u003e\",\n \"consumer-secret\": \"\u003cyour-oauth-consumer-secret\u003e\"\n }\n }\n }"]]