Cómo Importar un Sitio WordPress en XAMPP Desde un Backup SQL

Si cuentas con un sitio WordPress y dispones de un respaldo en formato .sql
o .sql.gz
, esta guía te ayudará a montar el sitio en tu entorno local con XAMPP de manera sencilla y eficiente.
1. Preparar el Entorno en XAMPP
- Instalar XAMPP
Descarga e instala XAMPP si aún no lo tienes. - Iniciar Servicios
Abre el Panel de Control de XAMPP y asegúrate de iniciar los servicios Apache y MySQL. - Acceder a phpMyAdmin
Desde tu navegador, ve ahttp://localhost/phpmyadmin
para gestionar las bases de datos.
2. Crear la Base de Datos en MySQL
- En phpMyAdmin, selecciona la pestaña "Bases de datos".
- Crea una nueva base de datos utilizando el nombre indicado en el archivo
wp-config.php
de tu sitio. Esto asegura que la configuración original se mantenga. - Es recomendable seleccionar el cotejamiento
utf8mb4_unicode_ci
para garantizar la correcta visualización de caracteres.
3. Importar el Archivo SQL
- Con la base de datos creada y seleccionada en phpMyAdmin, haz clic en la pestaña "Importar".
- Sube el archivo de respaldo. Si es un archivo comprimido (
.sql.gz
), phpMyAdmin lo descomprime automáticamente. - Haz clic en "Continuar" y espera a que finalice el proceso de importación.
Nota: Si encuentras algún error durante la importación, intenta descomprimir el archivo con una herramienta como WinRAR o 7-Zip y luego importa el archivo .sql
resultante.
4. Colocar los Archivos de WordPress en htdocs
- Copia la carpeta de tu sitio WordPress a la carpeta de documentos de XAMPP. En Windows, suele estar en
C:\xampp\htdocs\
; en macOS o Linux, en la ruta correspondiente a la instalación de XAMPP. - Verifica que en la carpeta se encuentren todos los archivos y directorios principales de WordPress (por ejemplo,
wp-config.php
,wp-content
,wp-includes
, etc.).
5. Configurar el Archivo wp-config.php
Abre el archivo wp-config.php
y asegúrate de que la configuración de la base de datos coincida con tu entorno local. Por ejemplo:
define('DB_NAME', 'TU_NOMBRE_DE_BASE_DE_DATOS'); // Reemplaza con el nombre de tu base de datos
define('DB_USER', 'root'); // Usuario de MySQL en XAMPP
define('DB_PASSWORD', ''); // Contraseña (por defecto, XAMPP no tiene contraseña)
define('DB_HOST', 'localhost'); // Servidor de la base de datos
Revisa además otras configuraciones específicas para asegurar la compatibilidad en tu entorno local.
6. Actualizar las URLs de WordPress
Si el sitio original estaba alojado en un dominio diferente, es importante actualizar las URLs para que apunten a tu entorno local. Para hacerlo:
- Accede a phpMyAdmin y selecciona la base de datos de tu sitio.
- Ejecuta la siguiente consulta SQL, modificando la URL de ejemplo por la ruta correspondiente a tu instalación local:
UPDATE wp_options
SET option_value = 'http://localhost/TU_CARPETA'
WHERE option_name = 'siteurl' OR option_name = 'home';
7. Solucionar el Mensaje de Solicitud de Credenciales FTP
En ocasiones, WordPress puede solicitar datos de acceso FTP para realizar ciertas operaciones (como actualizar plugins o temas). Para evitar este inconveniente:
- Abre el archivo
wp-config.php
. - Añade la siguiente línea antes del comentario que dice “/* That's all, stop editing! Happy publishing. */”:
define('FS_METHOD', 'direct');
Esta línea indica a WordPress que utilice el método directo para el manejo del sistema de archivos, eliminando la necesidad de credenciales FTP.
8. Ajustar los Permisos de los Directorios
Aunque en un entorno local con XAMPP normalmente no se presentan problemas de permisos, es importante asegurarse de que WordPress pueda escribir en los directorios necesarios:
- Windows:
Haz clic derecho sobre la carpeta de tu sitio, selecciona Propiedades > Seguridad y asegúrate de que tu usuario tenga permisos de lectura y escritura (idealmente, control total). - macOS/Linux:
Desde la terminal, navega hasta la carpeta del sitio y ejecuta comandos como:
sudo chmod -R 755 .
sudo chmod -R 775 wp-content
sudo chown -R tu_usuario:tu_grupo .
Asegúrate de reemplazar tu_usuario
y tu_grupo
por los valores correspondientes en tu sistema.
9. Iniciar el Servidor y Acceder a WordPress
- Asegúrate de que tanto Apache como MySQL estén en ejecución.
- Abre tu navegador y dirígete a
http://localhost/TU_CARPETA
(reemplaza “TU_CARPETA” por el nombre de la carpeta donde colocaste WordPress).
Si todo está correctamente configurado, deberías ver tu sitio WordPress funcionando en tu entorno local.
Consejos Adicionales y Buenas Prácticas
- Verifica los Logs de XAMPP:
Si experimentas errores inesperados, revisa los archivos de registro de Apache y MySQL que se encuentran en el Panel de Control de XAMPP. Estos logs pueden ofrecer pistas sobre problemas de conexión o permisos. - Utiliza WP-CLI:
Para usuarios más avanzados, WP-CLI es una herramienta de línea de comandos que facilita la administración de WordPress. Con WP-CLI puedes realizar tareas como actualizar la base de datos, buscar y reemplazar URLs, entre otras. - Copia de Seguridad Automatizada:
Además de realizar respaldos manuales, es recomendable utilizar plugins de respaldo confiables. Estos plugins automatizan la creación de copias de seguridad tanto de la base de datos como de los archivos, lo que simplifica futuros procesos de migración o restauración. - Realiza Pruebas Locales:
Antes de aplicar cambios en producción, prueba siempre en tu entorno local. Esto te permitirá identificar y corregir errores sin afectar el sitio en vivo. - Consejo del Autor
Tip de JadrDev:
Antes de comenzar cualquier migración o modificación importante, siempre realiza un respaldo completo tanto de la base de datos como de los archivos del sitio. Esta práctica te permitirá revertir cualquier cambio en caso de inconvenientes y mantener un registro seguro de tu configuración original. Además, revisa minuciosamente el archivo wp-config.php
y actualiza las URLs en la base de datos para evitar errores de conexión.
Conclusión
Montar un sitio WordPress en XAMPP a partir de un respaldo SQL puede parecer complejo, pero siguiendo estos pasos y aplicando buenas prácticas lograrás hacerlo de manera ordenada y sin contratiempos. Recuerda mantener tus respaldos actualizados, aprovechar herramientas como WP-CLI y, sobre todo, probar tus cambios en un entorno seguro antes de implementarlos en producción.
¡Esperamos que esta guía te sea de gran ayuda para trabajar en tus proyectos en local!