Usar Git con WordPress en cPanel: Guía para Desarrolladores

¿Por qué usar Git con WordPress en cPanel?

Si estás desarrollando WordPress, seguramente ya sabes lo frustrante que es perder cambios, romper algo y no poder volver atrás. Git es la solución que usan los desarrolladores profesionales para controlar cada versión de su código. Y lo mejor: puedes usarlo directamente en tu hosting con cPanel, sin necesidad de ser un experto en línea de comandos.

En esta guía, vamos a explicarte paso a paso cómo usar Git WordPress cPanel para que puedas gestionar tu sitio con control de versiones, hacer despliegues seguros y trabajar en equipo sin pisarte los archivos. No importa si eres principiante o ya tienes algo de experiencia, aquí lo encontrarás todo explicado de forma clara y sencilla.

¿Qué es el control de versiones WordPress y por qué lo necesitas?

El control de versiones WordPress es un sistema que registra cada cambio que haces en los archivos de tu sitio. Imagina que es una máquina del tiempo: puedes volver a cualquier punto anterior, ver quién hizo qué cambio y cuándo, y fusionar el trabajo de varias personas sin conflictos.

Sin control de versiones, cualquier error puede convertirse en un dolor de cabeza. Un plugin mal actualizado, un cambio de tema fallido o un archivo corrupto pueden dejar tu web caída. Con Git, simplemente reviertes al último estado estable y listo.

Además, Git te permite trabajar en ramas (branches). Esto significa que puedes experimentar con nuevas funcionalidades en una copia separada de tu sitio y, cuando estés seguro, fusionarla con la versión principal.

Requisitos previos para usar Git en cPanel

Antes de empezar, asegúrate de tener lo siguiente:

Acceso a cPanel de tu hosting (normalmente en tudominio.com/cPanel o tudominio.com:2083).
Acceso SSH habilitado. Esto es imprescindible para usar Git desde la terminal. Si no lo tienes, contacta con tu proveedor de hosting.
Conocimientos básicos de línea de comandos. No necesitas ser un hacker, pero saber navegar entre carpetas (cd), listar archivos (ls) y ejecutar comandos te será de gran ayuda.
Un repositorio Git remoto (en GitHub, GitLab o Bitbucket) o local si prefieres empezar sin servicios externos.

[INFO] Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el acceso a cPanel puede variar. En Syspanel, el puerto de acceso es el 2106 (por ejemplo, tudominio.com:2106). Aunque la interfaz es diferente, el proceso de configuración de Git es similar.

Paso 1: Activar el acceso SSH en cPanel

Lo primero es habilitar SSH en tu cuenta de hosting. Esto te permitirá conectarte a tu servidor y ejecutar comandos Git.

Inicia sesión en cPanel.
Busca la sección "Acceso SSH" o "SSH Access".
Haz clic en "Manage SSH Keys".
Genera una nueva clave SSH (pública y privada). Puedes usar una contraseña o dejarla vacía si solo la usarás tú.
Una vez generada, copia la clave pública y añádela a tu cuenta de GitHub, GitLab o Bitbucket (en la sección de claves SSH de tu perfil).

Con esto, podrás conectarte a tu servidor desde tu terminal local usando el comando:

ssh usuario@tudominio.com

Paso 2: Instalar Git en tu servidor

La mayoría de los hosts con cPanel ya tienen Git instalado. Para comprobarlo, conecta por SSH y ejecuta:

git --version

Si te aparece un número de versión, ¡genial! Ya lo tienes. Si no, puedes instalarlo fácilmente:

sudo apt-get install git

O si tu servidor usa otro gestor de paquetes:

yum install git

[TIP] Si no tienes permisos de administrador, contacta con tu proveedor de hosting para que te instalen Git. Es un requisito básico en casi todos los planes de hosting actuales.

Paso 3: Configurar tu usuario de Git

Antes de empezar a usar Git, es recomendable configurar tu nombre de usuario y correo electrónico. Esto quedará registrado en cada commit que hagas.

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

Paso 4: Crear un repositorio Git en tu proyecto WordPress

Ahora viene lo interesante. Tienes dos opciones: crear un repositorio desde cero o clonar uno existente.

Opción A: Crear un repositorio nuevo

Si tu sitio WordPress ya está funcionando en cPanel y quieres empezar a versionarlo desde ahora, sigue estos pasos:

Conéctate por SSH y navega hasta la carpeta de tu sitio web. Normalmente es public_html o www:

cd public_html

Inicializa el repositorio:

git init

Añade todos los archivos al área de staging:

git add .

Haz el primer commit:

git commit -m "Primer commit: estado inicial del sitio"

Opción B: Clonar un repositorio existente

Si ya tienes un proyecto en GitHub, puedes clonarlo directamente en tu servidor:

git clone https://github.com/tu-usuario/tu-repositorio.git public_html

Esto descargará todos los archivos del repositorio en la carpeta public_html.

Paso 5: Configurar el archivo .gitignore correctamente

Uno de los errores más comunes al usar Git WordPress cPanel es versionar archivos que no deberías. WordPress genera archivos de configuración y caché que varían según el entorno, como wp-config.php o la carpeta wp-content/cache.

Crea un archivo .gitignore en la raíz de tu proyecto con el siguiente contenido:

wp-config.php
wp-content/uploads/
wp-content/cache/
wp-content/advanced-cache.php
wp-content/object-cache.php
wp-content/wp-cache-config.php
.htaccess

Esto evitará que subas información sensible o archivos temporales a tu repositorio.

[WARNING] Nunca subas wp-config.php a un repositorio público. Contiene las credenciales de tu base de datos. Si lo haces, cambia inmediatamente tus contraseñas.

Paso 6: Trabajar con ramas para desarrollar sin miedo

Una de las grandes ventajas de desarrollar WordPress Git es poder usar ramas. Puedes tener una rama main (o master) con la versión estable de tu sitio, y crear ramas para experimentar.

Crear una nueva rama

git branch desarrollo
git checkout desarrollo

O directamente:

git checkout -b desarrollo

Cambiar entre ramas

git checkout main

Fusionar ramas

Cuando termines de trabajar en tu rama de desarrollo y quieras pasar los cambios a la principal:

git checkout main
git merge desarrollo

Paso 7: Hacer commits y gestionar cambios

Cada vez que hagas cambios en tu sitio (modificar un tema, añadir un plugin, etc.), debes "guardar" ese estado con un commit.

Ver el estado de tu repositorio

git status

Añadir archivos específicos

git add wp-content/themes/mi-tema/funciones.php

Añadir todo de una vez

git add .

Hacer el commit

git commit -m "Descripción clara del cambio"

Subir cambios al repositorio remoto

git push origin main

Descargar cambios del remoto

git pull origin main

Paso 8: Desplegar automáticamente con hooks (opcional)

Si quieres llevar tu flujo de trabajo al siguiente nivel, puedes configurar un hook de GitHub para que, cada vez que hagas un push, tu sitio en cPanel se actualice automáticamente.

Crea un archivo llamado deploy.php en la raíz de tu proyecto con este contenido básico:

<?php
$payload = json_decode(file_get_contents('php://input'), true);
if ($payload && isset($payload['ref'])) {
    $output = shell_exec('cd /home/usuario/public_html && git pull origin main 2>&1');
    echo $output;
}

En GitHub, ve a Settings > Webhooks y añade la URL de tu sitio con deploy.php (por ejemplo, https://tudominio.com/deploy.php).

Ahora, cada vez que hagas git push, tu sitio se actualizará solo.

Paso 9: Buenas prácticas para trabajar con WordPress y Git

Aquí tienes una lista de recomendaciones que te ahorrarán muchos dolores de cabeza:

Haz commits pequeños y frecuentes: Es más fácil revertir un cambio pequeño que uno gigante.
Escribe mensajes de commit descriptivos: "Corregido error en el menú de navegación" es mucho mejor que "arreglo".
No uses Git para la base de datos: Git versiona archivos, no bases de datos. Para eso necesitas plugins como WP Migrate DB Pro o herramientas como phpMyAdmin.
Prueba en un entorno de desarrollo: Si puedes, monta un WordPress local o en un subdominio y sincroniza con Git. Así nunca romperás la web en producción.
Actualiza los plugins y temas con cuidado: Antes de actualizar, haz un commit para poder revertir si algo sale mal.

Preguntas frecuentes sobre Git y WordPress en cPanel

¿Puedo usar Git en cPanel sin SSH?

No. Git requiere acceso a la terminal del servidor. Si tu hosting no ofrece SSH, no podrás usar Git directamente. Algunos hosts ofrecen interfaces gráficas para Git en cPanel, pero son limitadas.

¿Git ralentiza mi sitio web?

No. Git solo actúa cuando ejecutas comandos. No afecta al rendimiento de tu web en el día a día.

¿Qué hago si me equivoco con un commit?

Puedes revertir el último commit sin perder los cambios con:

git reset --soft HEAD~1

O si quieres descartar completamente los cambios:

git reset --hard HEAD~1

[WARNING] El comando git reset --hard borra los cambios de forma permanente. Úsalo con mucho cuidado.

¿Puedo usar Git con plugins como WP Rocket o W3 Total Cache?

Sí, pero debes asegurarte de que las carpetas de caché estén en el .gitignore. Si no, cada vez que se genere caché, Git lo verá como un cambio y tendrás commits innecesarios.

Conclusión

Usar Git en cPanel para desarrollar WordPress es una práctica que te hará la vida mucho más fácil. Con el control de versiones WordPress, tendrás tranquilidad, seguridad y un flujo de trabajo profesional, todo desde tu propio hosting.

Recuerda que puedes empezar poco a poco: primero crea el repositorio, haz tu primer commit y luego ve incorporando ramas y despliegues automáticos. En poco tiempo, no podrás imaginar trabajar sin Git.

Si tu hosting usa Syspanel, recuerda que el acceso se realiza por el puerto 2106 y que, aunque la interfaz sea distinta, los pasos son prácticamente los mismos. La clave está en tener SSH activado y Git instalado.

¿Tienes alguna duda o problema? Déjala en los comentarios y te ayudaremos a resolverla. ¡Feliz desarrollo!