descargar setup php - descargar código fuente setup php

Configure PHP con las extensiones requeridas, configuración de php.ini, soporte de cobertura de código y varias herramientas como Composer en GitHub Actions. Esta acción le brinda una interfaz multiplataforma para configurar el entorno PHP que necesita para probar su aplicación. Consulte la sección Uso y ejemplos para ver cómo usarlo.

Contenido

Soporte de sistema operativo/plataforma
- Corredores alojados en GitHub
- Corredores autohospedados
Soporte PHP
Soporte de extensión PHP
Soporte de herramientas
Soporte de cobertura
- xdebug
- PCOV
- Desactivar Cobertura
Uso
- Entradas
- Salidas
- Banderas
- Configuración básica
- Configuración de matriz
- Configuración de compilación nocturna
- Configuración de compilación de depuración
- Configuración segura para subprocesos
- Forzar configuración de actualización
- Configuración detallada
- Configuración de múltiples arcos
- Configuración autohospedada
- Configuración de pruebas locales
- Configuración JIT
- Extensiones de caché
- Dependencias del compositor de caché
- Autenticación del compositor de GitHub
- Autenticación de empaquetador privado
- Autenticación manual del compositor
- Scripts PHP en línea
- Emparejadores de problemas
- Ejemplos
Versionado
Licencia
Contribuciones
Apoye este proyecto
Dependencias
Lectura adicional

Soporte de sistema operativo/plataforma

Tanto los ejecutores GitHub-hosted como self-hosted son compatibles con setup-php en los siguientes sistemas operativos/plataformas.

Corredores alojados en GitHub

Entorno virtual	Etiqueta de flujo de trabajo YAML	PHP preinstalado
ubuntu 24.04	`ubuntu-24.04`	`PHP 8.3`
ubuntu 22.04	`ubuntu-latest` o `ubuntu-22.04`	`PHP 8.1`
ubuntu 20.04	`ubuntu-20.04`	`PHP 7.4` a `PHP 8.3`
Servidor Windows 2022	`windows-latest` o `windows-2022`	`PHP 8.3`
Servidor Windows 2019	`windows-2019`	`PHP 8.3`
macOS Secuoya 15.x	`macos-15`	-
macOS Sonoma 14.x	`macos-latest` o `macos-14`	-
macOS Ventura 13.x	`macos-13`	`PHP 8.3`

Corredores autohospedados

SO host/entorno virtual	Etiqueta de flujo de trabajo YAML
ubuntu 24.04	`self-hosted` o `Linux`
ubuntu 22.04	`self-hosted` o `Linux`
ubuntu 20.04	`self-hosted` o `Linux`
Debian 12	`self-hosted` o `Linux`
Debian 11	`self-hosted` o `Linux`
Windows 7 y más reciente	`self-hosted` o `Windows`
Windows Server 2012 R2 y más reciente	`self-hosted` o `Windows`
macOS Sequoia 15.x x86_64/arm64	`self-hosted` o `macOS`
macOS Sonoma 14.x x86_64/arm64	`self-hosted` o `macOS`
macOS Ventura 13.x x86_64/arm64	`self-hosted` o `macOS`

Consulte la configuración autohospedada para utilizar la acción en corredores autohospedados.
Los sistemas operativos basados en las versiones anteriores de Ubuntu y Debian también son compatibles con el mejor esfuerzo posible.
Si la versión de PHP solicitada está preinstalada, setup-php cambia a ella; de lo contrario, instala la versión de PHP.

Soporte PHP

En todos los sistemas operativos/plataformas compatibles, se pueden configurar las siguientes versiones de PHP según el corredor.

PHP 5.3 a PHP 8.5 en ejecutores alojados en GitHub, excepto para ejecutores macOS ARM64 (macos-14).
PHP 5.6 a PHP 8.5 en ejecutores macOS ARM64 alojados en GitHub (macos-14).
PHP 5.6 a PHP 8.5 en ejecutores autohospedados.

Versión PHP	Estabilidad	Soporte de lanzamiento	Apoyo al corredor
`5.3`	`Stable`	`End of life`	`GitHub-hosted`
`5.4`	`Stable`	`End of life`	`GitHub-hosted`
`5.5`	`Stable`	`End of life`	`GitHub-hosted`
`5.6`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`7.0`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`7.1`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`7.2`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`7.3`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`7.4`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`8.0`	`Stable`	`End of life`	`GitHub-hosted` , `self-hosted`
`8.1`	`Stable`	`Security fixes only`	`GitHub-hosted` , `self-hosted`
`8.2`	`Stable`	`Active`	`GitHub-hosted` , `self-hosted`
`8.3`	`Stable`	`Active`	`GitHub-hosted` , `self-hosted`
`8.4`	`Stable`	`Active`	`GitHub-hosted` , `self-hosted`
`8.5`	`Nightly`	`In development`	`GitHub-hosted` , `self-hosted`

Notas:

Al especificar 8.5 en la entrada php-version se instala una compilación nocturna de PHP 8.5.0-dev . Consulte la configuración de compilación nocturna para obtener más información.
Para usar JIT en PHP 8.0 y superior, consulte la sección de configuración JIT.

Soporte de extensión PHP

Las extensiones PHP se pueden configurar usando la entrada extensions . Acepta una string en formato csv.

En Ubuntu , se pueden configurar extensiones que están disponibles como paquete, disponibles en PECL o en un repositorio git.

- name : Setup PHP with PECL extension
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : imagick, swoole

En Windows , se pueden configurar extensiones disponibles en PECL que tienen el binario DLL .
En macOS , se pueden configurar extensiones disponibles en PECL o un repositorio git.
En Ubuntu y macOS para compilar e instalar una extensión desde un repositorio de git, siga esta guía.
Las extensiones instaladas junto con PHP, si se especifican, están habilitadas.
Se pueden configurar versiones específicas de extensiones disponibles en PECL añadiendo el sufijo del nombre de la extensión a la versión. Esto es útil para instalar versiones antiguas de extensiones que admiten versiones de PHP al final de su vida útil.

- name : Setup PHP with specific version of PECL extension
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 5.4 '
    extensions : swoole-1.9.3

Las extensiones con versiones preliminares disponibles en PECL se pueden configurar añadiendo al nombre de la extensión el sufijo de su estado, es decir, alpha , beta , devel o snapshot .

- name : Setup PHP with pre-release PECL extension
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : xdebug-beta

En Ubuntu y macOS para compilar e instalar una extensión de PECL con bibliotecas o configuración personalizada, siga esta guía.
Las extensiones compartidas se pueden desactivar anteponiendo el prefijo : . Todas las extensiones que dependen de la extensión especificada también se desactivarán.

- name : Setup PHP and disable opcache
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : :opcache

Todas las extensiones compartidas se pueden desactivar especificando none . Cuando no se especifica none junto con otras extensiones, se eleva al inicio de la entrada. Por lo tanto, todas las extensiones compartidas se deshabilitarán primero y luego se procesarán el resto de las extensiones en la entrada.

Nota: Esto deshabilita todas las extensiones compartidas principales y de terceros y, por lo tanto, puede dañar algunas herramientas que las necesitan. Las extensiones requeridas se habilitan nuevamente cuando las herramientas se configuran de la mejor manera posible. Por lo tanto, se recomienda agregar las extensiones necesarias para sus herramientas después de none en la entrada extensions para evitar problemas.

- name : Setup PHP without any shared extensions except mbstring
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : none, mbstring

La extensión intl se puede configurar con una versión ICU específica para PHP 5.6 y superior en flujos de trabajo Ubuntu añadiendo el sufijo intl a la versión ICU . Se admiten ICU 50.2 y versiones más recientes. Consulte ICU builds para conocer las versiones específicas admitidas.

- name : Setup PHP with intl
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : intl-70.1

Las extensiones cargadas de forma predeterminada después de ejecutar setup-php se pueden encontrar en la wiki.
Estas extensiones tienen soporte personalizado:
- cubrid y pdo_cubrid en Ubuntu .
- event , gearman , geos y relay en Ubuntu y macOS .
- blackfire , couchbase , ioncube , oci8 , pdo_firebird , pdo_oci , pecl_http , phalcon3 , phalcon4 , phalcon5 y zephir_parser en todos los sistemas operativos compatibles.
De forma predeterminada, las extensiones que no se pueden agregar o deshabilitar correctamente dejan un mensaje de error en los registros y la ejecución no se interrumpe. Para cambiar este comportamiento, puede establecer el indicador fail-fast en true .

- name : Setup PHP with fail-fast
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : oci8
  env :
    fail-fast : true

Soporte de herramientas

Estas herramientas se pueden configurar globalmente utilizando la entrada tools . Acepta una cadena en formato csv.

behat , blackfire , blackfire-player , box , castor , churn , codeception , composer , composer-dependency-analyser , composer-normalize , composer-prefetcher , composer-require-checker , composer-unused , cs2pr , deployer , ecs , flex , grpc_php_plugin , infection , parallel-lint , pecl , phan , phing , phinx , phive , php-config , php-cs-fixer , php-scoper , phpcbf , phpcpd , phpcs , phpdoc o phpDocumentor , phpize , phplint , phpmd , phpspec , phpstan , phpunit , phpunit-bridge , phpunit-polyfills , pint , prestissimo , protoc , psalm , rector , symfony o symfony-cli , vapor o vapor-cli , wp o wp-cli

- name : Setup PHP with tools
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : php-cs-fixer, phpunit

Además de las herramientas anteriores, cualquier herramienta o paquete de composición también se puede configurar globalmente especificándolo como vendor/package que coincida con el listado en Packagist. Este formato acepta las mismas restricciones de versión que composer .

- name : Setup PHP with tools
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : vimeo/psalm

Para configurar una versión particular de una herramienta, especifíquela en el formulario tool:version .
La versión puede tener el siguiente formato:
- Semver. Por ejemplo tool:1.2.3 o tool:1.2.3-beta1 .
- Versión mayor. Por ejemplo tool:1 o tool:1.x .
- Versión mayor y menor. Por ejemplo tool:1.2 o tool:1.2.x .
Cuando especifica solo la versión principal o la versión en formato major.minor , se configurará la última versión del parche que coincida con la entrada.
Con la excepción de las versiones principales de composer , si especifica solo la versión major o la versión en formato major.minor para una herramienta, puede obtener una velocidad limitada por la API de GitHub. Para evitar esto, se recomienda proporcionar un token GitHub OAuth. Puede hacerlo configurando la variable de entorno GITHUB_TOKEN . La variable de entorno COMPOSER_TOKEN ha quedado obsoleta en favor de GITHUB_TOKEN y se eliminará en la próxima versión principal.

- name : Setup PHP with tools
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : php-cs-fixer:3.64, phpunit:11.4
  env :
    GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }}

La última versión estable de composer está configurada de forma predeterminada. Puede configurar la versión requerida composer especificando la versión principal v1 o v2 , o la versión en formato major.minor o semver . Además, para el compositor también se pueden especificar snapshot y preview para configurar las versiones respectivas.

- name : Setup PHP with composer v2
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : composer:v2

Si no utiliza Composer en su flujo de trabajo, puede especificar tools: none para omitirlo.

- name : Setup PHP without composer
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : none

Las herramientas pear , pecl , phpize y php-config están configuradas de forma predeterminada para todas las versiones de PHP compatibles en Linux y macOS.
La última versión de blackfire cli se configura cuando se especifica blackfire en la entrada de herramientas. Consulte la documentación oficial para usar blackfire con GitHub Actions.
Las herramientas prestissimo y composer-prefetcher se omitirán a menos que también se especifique composer:v1 en la entrada de herramientas. Se recomienda dejar prestissimo y usar composer v2 .
De forma predeterminada, excepto las herramientas composer que no se pueden configurar correctamente y dejan un mensaje de error en los registros, la ejecución no se interrumpe. Para cambiar este comportamiento, puede establecer el indicador fail-fast en true .

- name : Setup PHP with fail-fast
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : deployer
  env :
    fail-fast : true

Notas

tools de entrada son útiles para configurar herramientas que solo se utilizan en flujos de trabajo de CI, manteniendo así ordenado su archivo composer.json .
Si no desea utilizar todas sus dependencias de desarrollo en el flujo de trabajo, puede ejecutar Composer con --no-dev e instalar las herramientas necesarias utilizando la entrada tools para acelerar su flujo de trabajo.
De forma predeterminada, COMPOSER_NO_INTERACTION se establece en 1 y COMPOSER_PROCESS_TIMEOUT se establece en 0 . De hecho, esto significa que los comandos de Composer en sus scripts no necesitan especificar --no-interaction .
Además, COMPOSER_NO_AUDIT se establece en 1 . Entonces, si desea auditar sus dependencias en busca de vulnerabilidades de seguridad, se recomienda agregar un paso composer audit antes de instalarlas.
Si desea configurar un COMPOSER_PROCESS_TIMEOUT diferente, puede configurarlo en su archivo de flujo de trabajo usando la palabra clave env .

- name : Setup PHP with composer and custom process timeout
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    COMPOSER_PROCESS_TIMEOUT : 300

Soporte de cobertura

xdebug

Especifique coverage: xdebug para usar Xdebug y deshabilitar PCOV .
Se ejecuta en todas las versiones de PHP compatibles.

- name : Setup PHP with Xdebug
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    coverage : xdebug

Cuando especifica coverage: xdebug , la última versión de Xdebug compatible con la versión PHP se configura de forma predeterminada.
Si necesita Xdebug 2.x en PHP 7.2, 7.3 o 7.4, puede especificar coverage: xdebug2 .

- name : Setup PHP with Xdebug 2.x
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 7.4 '
    coverage : xdebug2

Nota : Xdebug está habilitado de forma predeterminada en las imágenes de Ubuntu GitHub Actions, por lo que si no lo está utilizando en su flujo de trabajo, se recomienda deshabilitarlo, ya que eso tendrá un impacto positivo en el rendimiento de PHP. Consulte la sección de cobertura de inhabilitación para obtener más detalles.

PCOV

Especifique coverage: pcov para usar PCOV y deshabilite Xdebug .
Se ejecuta en PHP 7.1 y versiones más recientes de PHP.

Si el directorio de su código fuente no es src , lib o app , especifique pcov.directory usando la entrada ini-values .

- name : Setup PHP with PCOV
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    ini-values : pcov.directory=api # optional, see above for usage.
    coverage : pcov

PHPUnit 8.x y superiores admiten PCOV desde el primer momento.
Si está utilizando PHPUnit 5.x, 6.x o 7.x, necesita configurar pcov/clobber antes de ejecutar sus pruebas.

- name : Setup PCOV
  run : |
    composer require pcov/clobber
    vendor/bin/pcov clobber

Desactivar Cobertura

Especifique coverage: none para deshabilitar tanto Xdebug como PCOV .

Desactive la cobertura por estos motivos:

No estás generando informes de cobertura durante la prueba.
Está utilizando phpdbg para ejecutar sus pruebas.
Estás perfilando tu código usando blackfire .
Estás utilizando PHP en modo JIT. Consulte la sección de configuración JIT para obtener más detalles.

- name : Setup PHP with no coverage driver
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    coverage : none

Uso

Entradas

Especificar el uso with palabra clave

`php-version` (opcional)

Especifique la versión de PHP que desea configurar.
Acepta una string . Por ejemplo '8.4' .
Acepta lowest para configurar la versión de PHP más baja admitida.
Acepta la versión highest o latest para configurar la última versión estable de PHP.
Acepta nightly para configurar una compilación nocturna desde la rama maestra de PHP.
Acepta el formato dx , donde d es la versión principal. Por ejemplo 5.x , 7.x y 8.x
Consulte Soporte de PHP para conocer las versiones de PHP compatibles.
Si no se especifica, busca lo siguiente en orden:
- La entrada php-version-file si existe
- Un archivo composer.lock y el valor platform-overrides.php
- Un archivo composer.json y el valor config.platform.php

`php-version-file` (opcional)

Especifique un archivo con la versión de PHP que desea configurar.
Acepta una string . Por ejemplo '.phpenv-version' .
Consulte Soporte de PHP para conocer las versiones de PHP compatibles.
De forma predeterminada, se utiliza el archivo .php-version .
Si no se especifica y no se encuentra el archivo .php-version predeterminado, se configura la última versión estable de PHP.

`extensions` (opcional)

Especifique las extensiones que desea agregar o deshabilitar.
Acepta una string en formato csv. Por ejemplo mbstring, :opcache .
No acepta none para deshabilitar todas las extensiones compartidas.
Las extensiones compartidas con el prefijo : están deshabilitadas.
Consulte compatibilidad con extensiones PHP para obtener más información.

`ini-file` (opcional)

Especifique el archivo base php.ini .
Acepta production , development o none .
De forma predeterminada, se utiliza el archivo php.ini de producción.

`ini-values` (opcional)

Especifique los valores que desea agregar a php.ini .
Acepta una string en formato csv. Por ejemplo post_max_size=256M, max_execution_time=180 .
Acepta valores ini con comas si están entre comillas. Por ejemplo xdebug.mode="develop,coverage" .

`coverage` (opcional)

Especifique el controlador de cobertura de código que desea configurar.
Acepta xdebug , pcov o none .
Consulte soporte de cobertura para obtener más información.

`tools` (opcional)

Especifique las herramientas que desea configurar.
Acepta una string en formato csv. Por ejemplo: phpunit, phpcs
Consulte soporte de herramientas para conocer las herramientas compatibles.

Salidas

`php-version`

En GitHub Actions puedes asignar una id al paso setup-php , puedes usar la misma para obtener los resultados en un paso posterior.

Proporciona la versión PHP en formato semver.

- name : Setup PHP
  id : setup-php
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '

- name : Print PHP version
  run : echo ${{ steps.setup-php.outputs.php-version }}

Banderas

Especificar usando la palabra clave env

`fail-fast` (opcional)

Especifique marcar el flujo de trabajo como fallido si una extensión o herramienta no se puede configurar.
Esto cambia el modo predeterminado de advertencias elegantes a fallo rápido.
De forma predeterminada, está configurado en false .
Acepta true y false .

`phpts` (opcional)

Especifique configurar una compilación de PHP segura para subprocesos.
Acepta nts para no seguros para subprocesos y zts o ts para seguros para subprocesos.
De forma predeterminada, está configurado en nts .
Consulte configuración segura para subprocesos para obtener más información.

`update` (opcional)

Especifique actualizar PHP en el ejecutor a la última versión del parche.
Acepta true y false .
De forma predeterminada, está configurado en false .
Consulte Forzar configuración de actualización para obtener más información.

Consulte a continuación para obtener más información.

Configuración básica

Configure una versión de PHP particular.

 steps :
- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : mbstring, intl
    ini-values : post_max_size=256M, max_execution_time=180
    coverage : xdebug
    tools : php-cs-fixer, phpunit

Configuración de matriz

Configure múltiples versiones de PHP en múltiples sistemas operativos.

 jobs :
  run :
    runs-on : ${{ matrix.operating-system }}
    strategy :
      matrix :
        operating-system : ['ubuntu-latest', 'windows-latest', 'macos-latest']
        php-versions : ['8.2', '8.3', '8.4']
        phpunit-versions : ['latest']
        include :
          - operating-system : ' ubuntu-latest '
            php-versions : ' 8.1 '
            phpunit-versions : 10
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ${{ matrix.php-versions }}
        extensions : mbstring, intl
        ini-values : post_max_size=256M, max_execution_time=180
        coverage : xdebug
        tools : php-cs-fixer, phpunit:${{ matrix.phpunit-versions }}
      env :
        GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }}

Configuración de compilación nocturna

Configure una compilación nocturna de PHP 8.5 .

Estas versiones de PHP se encuentran actualmente en desarrollo activo y pueden contener errores y cambios importantes.
Es posible que algunas extensiones del espacio de usuario no admitan esta versión actualmente.

 steps :
- name : Setup nightly PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.5 '
    extensions : mbstring
    ini-values : post_max_size=256M, max_execution_time=180
    coverage : xdebug
    tools : php-cs-fixer, phpunit

Configuración de compilación de depuración

Configure una compilación PHP con símbolos de depuración.

Las versiones de producción de PHP sin símbolos de depuración están configuradas de forma predeterminada.
Puede utilizar la variable de entorno debug para configurar una compilación con símbolos de depuración para PHP 5.6 y superiores.

Notas

En Linux, los símbolos de depuración se agregan como archivos de información de depuración en el directorio /usr/lib/debug/.build-id . Estos archivos coinciden con el build-id en la sección ELF de los binarios de PHP y las herramientas de depuración como gdb pueden resolver los símbolos de estos archivos.
En Windows, los símbolos de depuración se agregan como archivos pdb en el directorio de instalación de PHP.
En macOS, los símbolos de depuración se compilan en archivos binarios.

 steps :
- name : Setup PHP with debugging symbols
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    debug : true # specify true or false

Configuración segura para subprocesos

Configure TS o NTS PHP.

Las versiones NTS están configuradas de forma predeterminada.

 jobs :
  run :
    runs-on : [ubuntu-latest, windows-latest, macos-latest]
    name : Setup PHP TS
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ' 8.4 '
      env :
        phpts : ts # specify ts or nts

Forzar configuración de actualización

Actualice al último parche de las versiones de PHP.

Las versiones de PHP preinstaladas no se actualizan a su última versión de parche de forma predeterminada.
Si falta ppa:ondrej/php en el entorno Ubuntu GitHub, la versión de PHP se actualiza a la última versión del parche.
Puede especificar la variable de entorno update en true para actualizar a la última versión.

- name : Setup PHP with latest versions
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    update : true # specify true or false

Configuración detallada

Depura tu flujo de trabajo

Para depurar cualquier problema, puede utilizar la etiqueta verbose en lugar de v2 .

- name : Setup PHP with logs
  uses : shivammathur/setup-php@verbose
  with :
    php-version : ' 8.4 '

Configuración de múltiples arcos

Configure PHP en múltiples arquitecturas en Ubuntu GitHub Runners.

PHP 5.6 a PHP 8.4 son compatibles con setup-php en múltiples arquitecturas en Ubuntu .
Para esto, puede usar imágenes shivammathur/node como contenedores. Estos tienen Nodejs compatibles instalados para setup-php .
Actualmente, para la configuración basada en ARM , necesitará ejecutores autohospedados.

 jobs :
  run :
    runs-on : ubuntu-latest
    container : shivammathur/node:latest-${{ matrix.arch }}
    strategy :
      matrix :
        arch : ["amd64", "i386"]
    steps :
      - name : Install PHP
        uses : shivammathur/setup-php@v2
        with :
          php-version : ' 8.4 '

Configuración autohospedada

Configure PHP en un ejecutor autohospedado.

Para configurar un ejecutor autohospedado en contenedores, consulte las siguientes guías según su sistema operativo base.
- linux
- ventanas
Para configurar el ejecutor directamente en el sistema operativo host o en una máquina virtual, siga esta guía de requisitos antes de configurar el ejecutor autohospedado.
Si su flujo de trabajo utiliza contenedores de servicios, configure el ejecutor en un host Linux o en una máquina virtual Linux. GitHub Actions no admite la virtualización anidada en Linux, por lo que los servicios no funcionarán en un contenedor dockerizado.

Se recomienda especificar la variable de entorno runner con el valor self-hosted para entornos autohospedados.

 jobs :
  run :
    runs-on : self-hosted
    strategy :
      matrix :
        php-versions : ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
    name : PHP ${{ matrix.php-versions }}
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ${{ matrix.php-versions }}
      env :
        runner : self-hosted

Notas

No configure varios ejecutores autohospedados en una única instancia de servidor, ya que el flujo de trabajo paralelo entrará en conflicto entre sí.
No configure ejecutores autohospedados en su entorno de desarrollo o en su servidor de producción.
Evite utilizar las mismas etiquetas para sus ejecutores self-hosted que utilizan los ejecutores GitHub-hosted .

Configuración de pruebas locales

Pruebe su flujo de trabajo Ubuntu localmente usando nektos/act .

 jobs :
  run :
    runs-on : ubuntu-latest
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ' 8.4 '

Ejecute el flujo de trabajo localmente con act usando imágenes de shivammathur/node docker.

Elija la etiqueta de imagen que coincida con la propiedad runs-on en su flujo de trabajo. Por ejemplo, si está utilizando ubuntu-20.04 en su flujo de trabajo, ejecute act -P ubuntu-20.04=shivammathur/node:2004 .

 # For runs-on: ubuntu-latest
act -P ubuntu-latest=shivammathur/node:latest

# For runs-on: ubuntu-24.04
act -P ubuntu-24.04=shivammathur/node:2404

# For runs-on: ubuntu-22.04
act -P ubuntu-22.04=shivammathur/node:2204

# For runs-on: ubuntu-20.04
act -P ubuntu-20.04=shivammathur/node:2004

Configuración JIT

Habilite Justo a tiempo (JIT) en PHP 8.0 y superior.

Para habilitar JIT, habilite opcache en modo cli configurando opcache.enable_cli=1 .
JIT entra en conflicto con Xdebug , PCOV y otras extensiones que anulan la función zend_execute_ex , por lo tanto, configure coverage: none y deshabilite dichas extensiones si se agregan.
De forma predeterminada, opcache.jit=1235 y opcache.jit_buffer_size=256M están configurados y se pueden cambiar usando la entrada ini-values .
Para obtener información detallada sobre las directivas relacionadas con JIT, consulte la official PHP documentation .

Por ejemplo, para habilitar JIT en modo tracing con un tamaño de búfer de 64 MB .

- name : Setup PHP with JIT in tracing mode
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    coverage : none
    ini-values : opcache.enable_cli=1, opcache.jit=tracing, opcache.jit_buffer_size=64M

Extensiones de caché

Puede almacenar en caché las extensiones PHP usando shivammathur/cache-extensions y action/cache GitHub Actions. Las extensiones que tardan mucho en configurarse cuando se almacenan en caché están disponibles en la siguiente ejecución del flujo de trabajo y se habilitan directamente. Esto reduce el tiempo de ejecución del flujo de trabajo.
Consulte shivammathur/cache-extensions para obtener más detalles.

Dependencias del compositor de caché

Si su proyecto usa Composer, puede conservar el directorio de caché interno del compositor. Las dependencias almacenadas en caché se cargan directamente en lugar de descargarlas durante la instalación. Los archivos almacenados en caché están disponibles durante las ejecuciones de verificación y reducirán el tiempo de ejecución del flujo de trabajo.

- name : Get composer cache directory
  id : composer-cache
  run : echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT

- name : Cache dependencies
  uses : actions/cache@v4
  with :
    path : ${{ steps.composer-cache.outputs.dir }}
    key : ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
    restore-keys : ${{ runner.os }}-composer-

- name : Install dependencies
  run : composer install --prefer-dist

Notas

No almacene en caché el directorio vendor usando action/cache ya que eso tendrá efectos secundarios.
Si no confirmas composer.lock , puedes usar el hash de composer.json como clave para tu caché.

 key : ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}

Si admite una variedad de dependencias composer y utiliza opciones prefer-lowest y prefer-stable , puede almacenarlas en su matriz y agregarlas a las claves.

 key : ${{ runner.os }}-composer-${{ matrix.prefer }}-${{ hashFiles('**/composer.lock') }}
restore-keys : ${{ runner.os }}-composer-${{ matrix.prefer }}-

Autenticación del compositor de GitHub

Si tiene varios flujos de trabajo que configuran múltiples herramientas o tiene muchas dependencias del compositor, es posible que alcance el límite de velocidad de GitHub para el compositor. Además, si especifica solo la versión principal o la versión en formato major.minor , puede alcanzar el límite de velocidad. Para evitar esto, puede especificar un token OAuth configurando la variable de entorno GITHUB_TOKEN . Puede utilizar el secreto GITHUB_TOKEN para este propósito.

La variable de entorno COMPOSER_TOKEN ha quedado obsoleta en favor de GITHUB_TOKEN y se eliminará en la próxima versión principal.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }}

Autenticación de empaquetador privado

Si utiliza Private Packagist para sus dependencias de compositor privado, puede configurar la variable de entorno PACKAGIST_TOKEN para autenticarse.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    PACKAGIST_TOKEN : ${{ secrets.PACKAGIST_TOKEN }}

Autenticación manual del compositor

Además de GitHub o Private Packagist, si desea autenticar repositorios privados alojados en otro lugar, puede configurar la variable de entorno COMPOSER_AUTH_JSON con los métodos de autenticación y las credenciales en formato json. Consulte la sección de autenticación en composer documentation para obtener más detalles.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    COMPOSER_AUTH_JSON : |
      {
        "http-basic": {
          "example.org": {
            "username": "${{ secrets.EXAMPLE_ORG_USERNAME }}",
            "password": "${{ secrets.EXAMPLE_ORG_PASSWORD }}"
          }
        }
      }

Scripts PHP en línea

Si tiene que ejecutar varias líneas de código PHP en su flujo de trabajo, puede hacerlo fácilmente sin guardarlo en un archivo.

Coloque el código en la propiedad de ejecución de un paso y especifique el shell como php {0} .

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '

- name : Run PHP code
  shell : php {0}
  run : |
    <?php
    $welcome = "Hello, world";
    echo $welcome;

Emparejadores de problemas

Los comparadores de problemas son configuraciones json que identifican errores y advertencias en sus registros y los muestran de manera destacada en la interfaz de usuario de GitHub Actions resaltándolos y creando anotaciones de código.

PHP

Configure los comparadores de problemas para su salida PHP agregando este paso después del paso setup-php .

- name : Setup problem matchers for PHP
  run : echo "::add-matcher::${{ runner.tool_cache }}/php.json"

Unidad PHP

Configure los comparadores de problemas para su salida PHPUnit agregando este paso después del paso setup-php .

- name : Setup problem matchers for PHPUnit
  run : echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"

PHPStan

PHPStan admite informes de errores en GitHub Actions, por lo que no requiere comparadores de problemas.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : phpstan

- name : Run PHPStan
  run : phpstan analyse src

Salmo

Psalm admite informes de errores en GitHub Actions con un formato de salida github .

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : psalm

- name : Run Psalm
  run : psalm --output-format=github

Herramientas con soporte de estilo de verificación

Para herramientas que admitan informes checkstyle como phpstan , psalm , php-cs-fixer y phpcs puede usar cs2pr para anotar su código.
Para ver ejemplos, consulte la documentación de cs2pr.

Aquí hay un ejemplo con phpcs .

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : cs2pr, phpcs

- name : Run phpcs
  run : phpcs -q --report=checkstyle src | cs2pr

Ejemplos

Ejemplos de uso de setup-php con varios marcos y paquetes PHP.

Marco/paquete	Sigue funcionando	Flujo de trabajo
fuego negro	`macOS` , `ubuntu` y `windows`	fuego negro.yml
Jugador de fuego negro	`macOS` , `ubuntu` y `windows`	jugador-blackfire.yml
CakePHP con `MySQL` y `Redis`	`ubuntu`	pastelphp-mysql.yml
CakePHP con `PostgreSQL` y `Redis`	`ubuntu`	pastelphp-postgres.yml
CakePHP sin servicios	`macOS` , `ubuntu` y `windows`	pastelphp.yml
CódigoIgniter	`macOS` , `ubuntu` y `windows`	codeigniter.yml
Laminas MVC	`macOS` , `ubuntu` y `windows`	laminas-mvc.yml
Laravel con `MySQL` y `Redis`	`ubuntu`	laravel-mysql.yml
Laravel con `PostgreSQL` y `Redis`	`ubuntu`	laravel-postgres.yml
Laravel sin servicios	`macOS` , `ubuntu` y `windows`	laravel.yml
Lumen con `MySQL` y `Redis`	`ubuntu`	lumen-mysql.yml
Lumen con `PostgreSQL` y `Redis`	`ubuntu`	lumen-postgres.yml
Lumen sin servicios	`macOS` , `ubuntu` y `windows`	lumen.yml
Phalcon con `MySQL`	`ubuntu`	phalcon-mysql.yml
Phalcon con `PostgreSQL`	`ubuntu`	phalcon-postgres.yml
Raíces/lecho de roca	`ubuntu`	lecho de roca.yml
Raíces/salvia	`ubuntu`	salvia.yml
Marco delgado	`macOS` , `ubuntu` y `windows`	marco-delgado.yml
Symfony con `MySQL`	`ubuntu`	Symfony-mysql.yml
Symfony con `PostgreSQL`	`ubuntu`	Symfony-postgres.yml
Symfony sin servicios	`macOS` , `ubuntu` y `windows`	Symfony.yml
Kit de inicio Yii2 con `MySQL`	`ubuntu`	yii2-mysql.yml
Kit de inicio Yii2 con `PostgreSQL`	`ubuntu`	yii2-postgres.yml

Versionado

Utilice la etiqueta v2 como versión setup-php . Es una etiqueta continua y está sincronizada con las últimas versiones menores y de parches. Con v2 obtienes automáticamente correcciones de errores, parches de seguridad, nuevas funciones y soporte para las últimas versiones de PHP.
También se pueden utilizar versiones de lanzamiento semánticas. Se recomienda utilizar dependabot con control de versiones semántico para mantener actualizadas las acciones en sus flujos de trabajo.
También se puede usar Confirmar SHA, pero no se recomienda a menos que configure herramientas para actualizarlas con cada lanzamiento de la acción.
Solo se etiquetará una nueva versión principal de la acción cuando haya cambios importantes en la API setup-php, es decir, entradas, salidas y indicadores de entorno.
Para depurar cualquier problema, la etiqueta verbose se puede utilizar temporalmente. Genera todos los registros y también se sincroniza con las últimas versiones.
Se desaconseja utilizar la rama main como versión, ya que podría interrumpir su flujo de trabajo después de lanzamientos importantes, ya que tienen cambios importantes.
Si está utilizando la etiqueta v1 o una versión 1.xy , debe cambiar a v2 ya que v1 ya no es compatible.

Licencia

Los scripts y la documentación de este proyecto están bajo la licencia MIT.
Este proyecto tiene múltiples dependencias. Sus licencias se pueden encontrar en sus respectivos repositorios.
El logotipo de setup-php es un trabajo derivado del logotipo de php.net y tiene la licencia CC BY-SA 4.0.

Contribuciones

¡Las contribuciones son bienvenidas!

Consulte la Guía del colaborador antes de comenzar.
Si tiene algún problema o desea sugerir una característica/mejora, inicie una discusión aquí.

Colaboradores de setup-php y otros proyectos relacionados

Apoye este proyecto

Destaca el proyecto y compártelo. Si escribe un blog, comparta su experiencia con el uso de setup-php .
Comuníquese si tiene alguna pregunta sobre el patrocinio de setup-php.

Muchos usuarios y organizaciones admiten setup-php a través de patrocinadores de GitHub.

Estas empresas proporcionan generosamente a setup-php sus productos y servicios para ayudar en el desarrollo de este proyecto.

Dependencias

Dependencias de Node.js
aaronparker/VcRedist
mlocati/powershell-phpmanager
ppa:ondrej/php
shivammathur/extensiones-de-caché
shivammathur/compositor-cache
shivammathur/extensiones-homebrew
shivammathur/homebrew-php
shivammathur/icu-intl
shivammathur/php-constructor
shivammathur/php-builder-windows
shivammathur/php-ubuntu
shivammathur/php5-darwin
shivammathur/php5-ubuntu

Lectura adicional

Acerca de las acciones de GitHub
Sintaxis de acciones de GitHub
Otras acciones impresionantes

Expandir

setup php

Contenido

Soporte de sistema operativo/plataforma

Corredores alojados en GitHub

Corredores autohospedados

Soporte PHP

Soporte de extensión PHP

Soporte de herramientas

Soporte de cobertura

xdebug

PCOV

Desactivar Cobertura

Uso

Entradas

php-version (opcional)

php-version-file (opcional)

extensions (opcional)

ini-file (opcional)

ini-values (opcional)

coverage (opcional)

tools (opcional)

Salidas

php-version

Banderas

fail-fast (opcional)

phpts (opcional)

update (opcional)

Configuración básica

Configuración de matriz

Configuración de compilación nocturna

Configuración de compilación de depuración

Configuración segura para subprocesos

Forzar configuración de actualización

Configuración detallada

Configuración de múltiples arcos

Configuración autohospedada

Configuración de pruebas locales

Configuración JIT

Extensiones de caché

Dependencias del compositor de caché

Autenticación del compositor de GitHub

Autenticación de empaquetador privado

Autenticación manual del compositor

Scripts PHP en línea

Emparejadores de problemas

PHP

Unidad PHP

PHPStan

Salmo

Herramientas con soporte de estilo de verificación

Ejemplos

Versionado

Licencia

Contribuciones

Apoye este proyecto

Dependencias

Lectura adicional

`php-version` (opcional)

`php-version-file` (opcional)

`extensions` (opcional)

`ini-file` (opcional)

`ini-values` (opcional)

`coverage` (opcional)

`tools` (opcional)

`php-version`

`fail-fast` (opcional)

`phpts` (opcional)

`update` (opcional)