{"id":8538,"date":"2024-06-06T22:20:21","date_gmt":"2024-06-06T20:20:21","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/desarrollo-web\/como-ejecutar-composer-en-una-version-diferente-de-php-de-cpanel\/"},"modified":"2026-06-15T10:25:31","modified_gmt":"2026-06-15T08:25:31","slug":"como-ejecutar-composer-en-una-version-diferente-de-php-de-cpanel","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/como-ejecutar-composer-en-una-version-diferente-de-php-de-cpanel\/","title":{"rendered":"C\u00f3mo ejecutar Composer con una versi\u00f3n espec\u00edfica de PHP en cPanel"},"content":{"rendered":"<p>Por defecto, Composer se ejecuta con la versi\u00f3n m\u00e1s reciente de PHP disponible en el servidor. Si tu proyecto requiere una versi\u00f3n espec\u00edfica de PHP \u2014 por ejemplo, porque tienes el dominio configurado con PHP 8.1 pero el Composer del sistema usa PHP 8.3 \u2014 puedes configurar un alias en el archivo <code>.bashrc<\/code> de tu usuario de cPanel para que Composer use siempre la versi\u00f3n que necesitas.<\/p>\n<p>Para seguir esta gu\u00eda necesitas acceso SSH al servidor. Consulta la gu\u00eda <a href=\"https:\/\/www.nicalia.com\/nicapedia\/acceder-mediante-ssh-a-un-usuario\/\">c\u00f3mo acceder por SSH a tu hosting de Nicalia<\/a>.<\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: VERSIONES PHP DISPONIBLES\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Rutas de PHP disponibles en cPanel (EasyApache)<\/h2>\n<p>En los servidores de Nicalia con EasyApache, cada versi\u00f3n de PHP tiene su propio binario en una ruta del tipo <code>\/opt\/cpanel\/ea-phpXX\/root\/usr\/bin\/php<\/code>. Sustituye <code>XX<\/code> por la versi\u00f3n que necesites:<\/p>\n<table>\n<thead>\n<tr>\n<th>Versi\u00f3n PHP<\/th>\n<th>Ruta del binario<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>PHP 7.4<\/td>\n<td><code>\/opt\/cpanel\/ea-php74\/root\/usr\/bin\/php<\/code><\/td>\n<\/tr>\n<tr>\n<td>PHP 8.0<\/td>\n<td><code>\/opt\/cpanel\/ea-php80\/root\/usr\/bin\/php<\/code><\/td>\n<\/tr>\n<tr>\n<td>PHP 8.1<\/td>\n<td><code>\/opt\/cpanel\/ea-php81\/root\/usr\/bin\/php<\/code><\/td>\n<\/tr>\n<tr>\n<td>PHP 8.2<\/td>\n<td><code>\/opt\/cpanel\/ea-php82\/root\/usr\/bin\/php<\/code><\/td>\n<\/tr>\n<tr>\n<td>PHP 8.3<\/td>\n<td><code>\/opt\/cpanel\/ea-php83\/root\/usr\/bin\/php<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u2139\ufe0f Para comprobar qu\u00e9 versiones est\u00e1n disponibles en tu servidor, ejecuta por SSH: <code>ls \/opt\/cpanel\/ | grep ea-php<\/code><\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: CONFIGURAR EL ALIAS\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>C\u00f3mo configurar el alias de Composer con una versi\u00f3n PHP espec\u00edfica<\/h2>\n<h3>Paso 1 \u2014 Acceder al archivo .bashrc<\/h3>\n<p>Accede al <a href=\"https:\/\/www.nicalia.com\/nicapedia\/acceder-al-administrador-de-archivos\/\">Administrador de archivos de cPanel<\/a> y navega al directorio ra\u00edz de tu cuenta de cPanel (<code>\/home\/USUARIOCPANEL\/<\/code>). Activa la visualizaci\u00f3n de archivos ocultos (<em>Ajustes \u2192 Mostrar archivos ocultos<\/em>) y abre el archivo <code>.bashrc<\/code> para editar.<\/p>\n<p>Tambi\u00e9n puedes editarlo directamente por SSH:<\/p>\n<pre><code>nano \/home\/USUARIOCPANEL\/.bashrc<\/code><\/pre>\n<h3>Paso 2 \u2014 A\u00f1adir el alias<\/h3>\n<p>A\u00f1ade las siguientes l\u00edneas al final del archivo <code>.bashrc<\/code>, sustituyendo <code>ea-php74<\/code> por la versi\u00f3n de PHP que necesites (consulta la tabla anterior):<\/p>\n<pre><code>alias composer=\"\/opt\/cpanel\/ea-php74\/root\/usr\/bin\/php -d allow_url_fopen=1 -d disable_functions=none ~\/bin\/composer\/composer.phar\"<\/code><\/pre>\n<p><strong>Explicaci\u00f3n de cada parte del alias:<\/strong><\/p>\n<ul>\n<li><code>\/opt\/cpanel\/ea-php74\/root\/usr\/bin\/php<\/code> \u2014 ruta al binario de PHP 7.4 en EasyApache. C\u00e1mbiala por la versi\u00f3n que necesitas.<\/li>\n<li><code>-d allow_url_fopen=1<\/code> \u2014 activa <code>allow_url_fopen<\/code> para esta ejecuci\u00f3n, necesario para que Composer pueda descargar paquetes desde internet.<\/li>\n<li><code>-d disable_functions=none<\/code> \u2014 desactiva temporalmente la lista de funciones PHP deshabilitadas, que a veces bloquea funciones que Composer necesita.<\/li>\n<li><code>~\/bin\/composer\/composer.phar<\/code> \u2014 ruta al archivo de Composer instalado en tu cuenta de cPanel.<\/li>\n<\/ul>\n<h3>Paso 3 \u2014 Guardar el archivo<\/h3>\n<p>Guarda los cambios en el archivo <code>.bashrc<\/code>.<\/p>\n<h3>Paso 4 \u2014 Aplicar el alias en la sesi\u00f3n actual<\/h3>\n<p>El alias se aplica autom\u00e1ticamente en las pr\u00f3ximas sesiones SSH. Para aplicarlo en la sesi\u00f3n actual sin cerrar y volver a abrir la conexi\u00f3n, ejecuta:<\/p>\n<pre><code>source ~\/.bashrc<\/code><\/pre>\n<p>A partir de ahora, al ejecutar <code>composer<\/code> usar\u00e1 la versi\u00f3n de PHP que hayas configurado en el alias.<\/p>\n<p>Verifica que funciona correctamente:<\/p>\n<pre><code>composer --version<\/code><\/pre>\n<p>El resultado mostrar\u00e1 la versi\u00f3n de Composer y la versi\u00f3n de PHP que est\u00e1 usando.<\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: M\u00c9TODO ALTERNATIVO\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>M\u00e9todo alternativo: ejecutar Composer directamente con una versi\u00f3n PHP<\/h2>\n<p>Si solo necesitas ejecutar Composer con una versi\u00f3n PHP diferente de forma puntual, sin modificar el <code>.bashrc<\/code>, puedes hacerlo directamente en un solo comando:<\/p>\n<pre><code>\/opt\/cpanel\/ea-php81\/root\/usr\/bin\/php -d allow_url_fopen=1 ~\/bin\/composer\/composer.phar install<\/code><\/pre>\n<p>Sustituye <code>ea-php81<\/code> por la versi\u00f3n deseada e <code>install<\/code> por el subcomando de Composer que necesites (<code>update<\/code>, <code>require nombre\/paquete<\/code>, etc.).<\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: ERRORES COMUNES\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Errores frecuentes al ejecutar Composer con versi\u00f3n PHP diferente<\/h2>\n<h3>\u00abNo such file or directory\u00bb \u2014 la ruta al binario PHP no existe<\/h3>\n<p>La versi\u00f3n de PHP que intentas usar no est\u00e1 instalada en el servidor con EasyApache. Verifica las versiones disponibles ejecutando <code>ls \/opt\/cpanel\/ | grep ea-php<\/code> por SSH. Solo puedes usar las versiones que aparecen en esa lista.<\/p>\n<h3>\u00abCould not open file composer.phar\u00bb \u2014 Composer no est\u00e1 instalado en la ruta indicada<\/h3>\n<p>El archivo <code>composer.phar<\/code> no se encuentra en <code>~\/bin\/composer\/<\/code>. Verifica d\u00f3nde est\u00e1 instalado Composer en tu cuenta ejecutando <code>which composer<\/code> o <code>find ~ -name composer.phar 2>\/dev\/null<\/code>. Si Composer no est\u00e1 instalado, inst\u00e1lalo primero siguiendo la <a href=\"https:\/\/getcomposer.org\/download\/\" rel=\"nofollow noopener\" target=\"_blank\">gu\u00eda oficial de instalaci\u00f3n de Composer<\/a>.<\/p>\n<h3>El alias no funciona despu\u00e9s de a\u00f1adirlo al .bashrc<\/h3>\n<p>El <code>.bashrc<\/code> solo se ejecuta autom\u00e1ticamente en nuevas sesiones de shell interactivo. Para aplicarlo en la sesi\u00f3n actual sin reconectar, ejecuta <code>source ~\/.bashrc<\/code>. Si el alias sigue sin funcionar, verifica que no hay errores de sintaxis en el archivo <code>.bashrc<\/code> \u2014 una comilla mal cerrada puede impedir que se cargue correctamente.<\/p>\n<h3>Composer falla con \u00abYour PHP version does not satisfy that requirement\u00bb<\/h3>\n<p>El proyecto requiere una versi\u00f3n de PHP diferente a la que est\u00e1s usando en el alias. Actualiza el alias en <code>.bashrc<\/code> para usar la versi\u00f3n PHP que el proyecto requiere (verificable en el <code>composer.json<\/code> del proyecto en la secci\u00f3n <code>require.php<\/code>).<\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: FAQ\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Preguntas frecuentes<\/h2>\n<h3>\u00bfPor qu\u00e9 Composer puede usar una versi\u00f3n de PHP diferente a la del dominio?<\/h3>\n<p>Composer se ejecuta desde la l\u00ednea de comandos SSH con el PHP del sistema, que puede ser diferente a la versi\u00f3n configurada para el dominio en cPanel. El PHP del dominio se usa para las peticiones web (Apache\/LiteSpeed), mientras que el PHP de l\u00ednea de comandos es el que usa por defecto Composer. El alias en <code>.bashrc<\/code> soluciona esta discrepancia.<\/p>\n<h3>\u00bfEl alias en .bashrc afecta a otros comandos del servidor?<\/h3>\n<p>No. Un alias en <code>.bashrc<\/code> solo afecta al usuario de cPanel para el que lo configuras y solo al comando <code>composer<\/code> \u2014 no cambia la versi\u00f3n de PHP del sistema ni de ninguna otra herramienta.<\/p>\n<h3>\u00bfC\u00f3mo verificar con qu\u00e9 versi\u00f3n de PHP se est\u00e1 ejecutando Composer?<\/h3>\n<p>Ejecuta <code>composer --version<\/code> \u2014 mostrar\u00e1 la versi\u00f3n de Composer y la versi\u00f3n de PHP que est\u00e1 usando. O directamente: <code>composer diagnose<\/code>, que muestra informaci\u00f3n detallada del entorno incluyendo la versi\u00f3n de PHP.<\/p>\n<h3>\u00bfQu\u00e9 diferencia hay entre el alias en .bashrc y el m\u00e9todo de comando directo?<\/h3>\n<p>El alias en <code>.bashrc<\/code> es persistente \u2014 cada vez que ejecutes <code>composer<\/code> en cualquier sesi\u00f3n SSH usar\u00e1 la versi\u00f3n PHP configurada. El m\u00e9todo de comando directo (invocar el binario PHP directamente) es puntual \u2014 solo aplica para esa ejecuci\u00f3n concreta. Para uso habitual en desarrollo, el alias es m\u00e1s c\u00f3modo. Para una \u00fanica ejecuci\u00f3n, el comando directo evita modificar la configuraci\u00f3n.<\/p>\n<h3>\u00bfPuedo tener varios alias de Composer para diferentes versiones PHP?<\/h3>\n<p>S\u00ed. Puedes crear m\u00faltiples alias con nombres diferentes en el <code>.bashrc<\/code>:<\/p>\n<pre><code>alias composer81=\"\/opt\/cpanel\/ea-php81\/root\/usr\/bin\/php -d allow_url_fopen=1 ~\/bin\/composer\/composer.phar\"\nalias composer82=\"\/opt\/cpanel\/ea-php82\/root\/usr\/bin\/php -d allow_url_fopen=1 ~\/bin\/composer\/composer.phar\"<\/code><\/pre>\n<p>Luego usa <code>composer81<\/code> o <code>composer82<\/code> seg\u00fan el proyecto que est\u00e9s trabajando.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Por defecto, Composer se ejecuta con la versi\u00f3n m\u00e1s reciente de PHP disponible en el servidor. Si tu proyecto requiere una versi\u00f3n espec\u00edfica de PHP \u2014 por ejemplo, porque tienes el dominio configurado con PHP 8.1 pero el Composer del sistema usa PHP 8.3 \u2014 puedes configurar un alias en el archivo .bashrc de tu [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":5635,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-8538","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/4471485c4e49f46218d6b6d125f80f4cde1f86f045fd896202eefddaf4d4510a?s=96&d=mm&r=g","author_name":"Francisco Garvi","_links":{"self":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/8538","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/comments?post=8538"}],"version-history":[{"count":4,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/8538\/revisions"}],"predecessor-version":[{"id":10152,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/8538\/revisions\/10152"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/5635"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=8538"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=8538"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=8538"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}