Especificar dependencias

Puedes declarar dependencias de PHP en un archivo composer.json estándar. Por ejemplo:

{
    "require": {
        "google/cloud": "^0.72"
    }
}

Puedes usar cualquier paquete PHP compatible con Linux en App Engine. El tiempo de ejecución busca un archivo composer.json en el directorio de origen de tu aplicación y usa composer para instalar las dependencias antes de iniciar la aplicación.

Para obtener información sobre las versiones de PHP compatibles con este entorno de ejecución, consulta Entorno de ejecución de PHP.

Instalar y ejecutar de forma local

Usa composer para instalar las dependencias de forma local:

composer install

Para fijar las dependencias en su versión actual, confirma el archivo composer.lock en tu aplicación.

Puedes probar tu aplicación con el servidor web que elijas. El entorno flexible de App Engine usa NGINX en producción. Para ejecutar rápidamente tu aplicación, puedes usar el servidor web integrado de PHP.

Instalar un framework web

De forma predeterminada, NGINX está configurado para servir todas las solicitudes a través de index.php. No es obligatorio usar un framework, pero sí recomendable. Puedes usar cualquier framework web con los entornos flexibles de App Engine, incluidos los siguientes:

Para usar un framework web concreto, solo tienes que añadirlo a composer.json:

{
    "require": {
        "symfony/symfony": " ^3.0"
    }
}

Instalar las bibliotecas de cliente de Cloud

La biblioteca de cliente de Google Cloud para PHP es una biblioteca de cliente para acceder a los servicios de Google Cloud , que reduce el código repetitivo que tienes que escribir. La biblioteca proporciona abstracciones de API de alto nivel y fáciles de entender. Se adapta a las expresiones idiomáticas de PHP, funciona bien con la biblioteca estándar y se integra mejor con tu base de código. Todo esto significa que puedes dedicar más tiempo a crear el código que te importa.

  1. Instala la biblioteca localmente:

    composer require google/cloud

  2. Puedes gestionar la autenticación de forma local mediante la CLI de Google Cloud. Si quieres que tu aplicación local use temporalmente tus propias credenciales de usuario para acceder a la API, ejecuta el siguiente comando:

    gcloud auth application-default login

    Para obtener información sobre cómo configurar las bibliotecas de cliente de Cloud para PHP de forma que gestionen la autenticación automáticamente, consulta el artículo Autenticarse en servicios de Cloud con bibliotecas de cliente.

Usar repositorios privados

Para usar bibliotecas en repositorios privados, debes completar las siguientes tareas:

  • Configura el repositorio.
  • Proporciona a composer el secreto para acceder al repositorio privado.

En el siguiente ejemplo se muestra cómo acceder a un repositorio privado en GitHub.

  1. Configura el repositorio en composer.json usando vcs para el tipo:

    "repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/username/private_package"
    }
]

  2. Crea un archivo llamado auth.json en el directorio raíz de tu proyecto:

    {
    "github-oauth": {
        "github.com": "<your-github-auth-token>"
    }
}

Puedes obtener el token de autenticación de GitHub en la interfaz de usuario administrativa de GitHub.

Aquí tienes otro ejemplo que muestra cómo acceder a un repositorio privado de Bitbucket.

  1. Configura el repositorio en composer.json usando vcs para el tipo:

    "repositories": [
    {
        "type": "vcs",
        "url":  "https://bitbucket.org/username/private_git"
    }
]

  2. Crea un archivo llamado auth.json en el directorio raíz de tu proyecto:

    {
    "bitbucket-oauth": {
        "bitbucket.org": {
            "consumer-key": "<your-oauth-consumer-key>",
            "consumer-secret": "<your-oauth-consumer-secret>"
        }
    }
}