<\/p>\n
Aprende a crear comandos personalizados en WP-CLI para automatizar tareas, ampliar WordPress y trabajar m\u00e1s r\u00e1pido desde consola.<\/p>\n
WP-CLI no solo sirve para gestionar WordPress desde la terminal: tambi\u00e9n permite extender su funcionalidad con comandos personalizados<\/strong>. Esto resulta especialmente \u00fatil cuando repites procesos internos, mantienes varios sitios o necesitas convertir una tarea t\u00e9cnica en un flujo r\u00e1pido y estandarizado.<\/p>\n Si ya dominas los comandos b\u00e1sicos y las tareas m\u00e1s habituales, este paso te lleva un nivel m\u00e1s all\u00e1. En art\u00edculos anteriores vimos c\u00f3mo usar WP-CLI para administrar WordPress de forma general, automatizar tareas con cron o trabajar en scripts bash. Ahora vamos a centrarnos en c\u00f3mo crear tus propios comandos para que la consola se adapte a tu forma de trabajar, no al rev\u00e9s.<\/p>\n Un comando personalizado es una orden que t\u00fa defines y que WP-CLI puede ejecutar como si formara parte del sistema. En lugar de escribir una secuencia larga de instrucciones cada vez, encapsulas esa l\u00f3gica en una clase o en un archivo PHP y la reutilizas cuando quieras.<\/p>\n La ventaja es doble: ahorras tiempo y reduces errores humanos. En entornos con mucho mantenimiento, despliegues frecuentes o varias instalaciones, esto encaja muy bien con lo que ya vimos en la gu\u00eda de gesti\u00f3n de m\u00faltiples instalaciones con WP-CLI<\/a> y con los comandos avanzados de WP-CLI<\/a>.<\/p>\n Los comandos personalizados son ideales para tareas repetitivas como generar reportes, limpiar opciones espec\u00edficas, validar configuraci\u00f3n, sincronizar datos entre entornos o lanzar rutinas internas de mantenimiento.<\/p>\n Tambi\u00e9n son una buena forma de estandarizar operaciones cuando varias personas trabajan sobre el mismo proyecto. En vez de depender de que cada miembro recuerde una serie de pasos, defines un comando claro, documentado y reutilizable.<\/p>\n WP-CLI permite registrar comandos mediante c\u00f3digo PHP. A nivel pr\u00e1ctico, eso significa que puedes crear una clase, asociarla a un nombre de comando y definir m\u00e9todos para subcomandos o acciones concretas.<\/p>\n La estructura es sencilla: WP-CLI carga tu archivo, registra la clase y te deja invocarla desde la terminal con una sintaxis coherente. Esto es especialmente \u00fatil cuando desarrollas herramientas internas para un plugin o un entorno de despliegue.<\/p>\n Antes de crear un comando nuevo, conviene tener claro d\u00f3nde lo vas a ejecutar. Si trabajas en despliegues automatizados, te interesar\u00e1 apoyar esta pr\u00e1ctica con lo aprendido en despliegues autom\u00e1ticos de WordPress con WP-CLI<\/a> y, si recurres a scripts, con WP-CLI en scripts bash<\/a>.<\/p>\n Una de las formas m\u00e1s habituales de extender WP-CLI es crear un archivo PHP dentro de un plugin propio o de un mu-plugin. As\u00ed mantienes el comando versionado junto al proyecto y no dependes de una instalaci\u00f3n aislada en el servidor.<\/p>\n El siguiente ejemplo muestra una base sencilla para registrar un comando que saluda y acepta un argumento. No pretende ser complejo, pero s\u00ed ilustrar la estructura m\u00ednima.<\/p>\n En este caso, el comando se invocar\u00eda como wp mi-comando saludar –nombre=Ana<\/strong>. La salida, adem\u00e1s, usa las utilidades de WP-CLI para mostrar mensajes m\u00e1s claros en consola.<\/p>\n Para un ejemplo r\u00e1pido, una funci\u00f3n aislada puede parecer suficiente. Pero si el proyecto crece, una clase ofrece mejor organizaci\u00f3n, facilita a\u00f1adir m\u00e1s subcomandos y mejora la legibilidad del c\u00f3digo.<\/p>\n Si tu idea es crear una herramienta reutilizable, piensa en t\u00e9rminos de arquitectura: nombre del comando, subcomandos, validaci\u00f3n de argumentos y salida consistente. Esa mentalidad evita que el c\u00f3digo se convierta en un parche dif\u00edcil de mantener.<\/p>\n Un error com\u00fan al crear comandos personalizados es mezclar demasiada l\u00f3gica en un \u00fanico m\u00e9todo. Lo m\u00e1s recomendable es separar responsabilidades: una parte para validar entradas, otra para ejecutar la tarea y otra para informar del resultado.<\/p>\n Tambi\u00e9n es buena idea usar nombres descriptivos. Si tu comando automatiza una acci\u00f3n de mantenimiento, el nombre deber\u00eda dejarlo claro. As\u00ed, cualquiera que vea el comando puede entender su prop\u00f3sito sin abrir el archivo PHP.<\/p>\n La validaci\u00f3n es clave cuando el comando recibe par\u00e1metros. Si esperas una ruta, un ID o una URL, comprueba siempre que el valor existe y tiene el formato esperado antes de continuar. Un comando personalizado debe ser \u00fatil, pero tambi\u00e9n seguro y predecible.<\/p>\n En cuanto a los mensajes, WP-CLI ofrece formas simples de comunicar \u00e9xito, error o advertencia. Usarlas bien mejora mucho la experiencia desde consola, sobre todo cuando el comando se integra en automatizaciones o pipelines.<\/p>\n No conviertas WP-CLI en un contenedor de l\u00f3gica de negocio enorme. Es mejor registrarlo para tareas operativas, administrativas o repetitivas. Si una operaci\u00f3n pertenece al dominio de tu plugin, puedes usar el comando como interfaz de mantenimiento, no como sustituto de la arquitectura principal.<\/p>\n Este enfoque encaja especialmente bien con flujos donde ya gestionas backups, bases de datos o contenido desde terminal, como en hacer un backup de WordPress con WP-CLI<\/a> o en exportar e importar la base de datos con WP-CLI<\/a>.<\/p>\n La forma m\u00e1s pr\u00e1ctica de distribuir comandos personalizados es incluirlos en un plugin propio. As\u00ed los despliegas junto con el c\u00f3digo del proyecto y evitas copiar archivos manualmente en cada servidor.<\/p>\n Si el comando es cr\u00edtico para operaciones internas, un mu-plugin<\/strong> puede ser todav\u00eda m\u00e1s adecuado, porque carga siempre con WordPress. Esto resulta \u00fatil en entornos donde quieres garantizar que la utilidad est\u00e9 disponible incluso antes de activar plugins convencionales.<\/p>\n En proyectos avanzados, esta estrategia se combina bien con mantenimiento programado, tareas de consola y automatizaci\u00f3n. De hecho, si ya trabajas con cron, puedes revisar la gu\u00eda sobre automatizar tareas de WordPress con WP-CLI y cron<\/a> para ver c\u00f3mo encaja todo.<\/p>\n Uno de los fallos m\u00e1s comunes es asumir que el entorno ser\u00e1 siempre id\u00e9ntico. En la pr\u00e1ctica, un comando puede ejecutarse en local, staging o producci\u00f3n, as\u00ed que conviene evitar dependencias fr\u00e1giles, rutas absolutas innecesarias o supuestos sobre el contenido del sitio.<\/p>\n Otro error habitual es no documentar el comando. A\u00f1adir ejemplos de uso y descripciones de par\u00e1metros te ahorrar\u00e1 tiempo a futuro, tanto si lo usas t\u00fa solo como si lo compartes con un equipo.<\/p>\n Tambi\u00e9n merece atenci\u00f3n la compatibilidad. Si tu flujo depende de m\u00faltiples sitios o de instalaciones gestionadas en paneles como Plesk o cPanel, revisa c\u00f3mo se comporta la consola en cada caso. Puedes apoyarte en esta gu\u00eda pr\u00e1ctica sobre WP-CLI en Plesk o cPanel<\/a> para tener un contexto m\u00e1s amplio.<\/p>\n Crear comandos personalizados en WP-CLI es una evoluci\u00f3n natural para cualquier usuario que ya haya pasado de lo b\u00e1sico a la automatizaci\u00f3n real. Te permite convertir procesos repetitivos en herramientas reutilizables, mejorar la consistencia operativa y ahorrar tiempo en tareas de mantenimiento.<\/p>\n Si ya trabajas con WP-CLI para instalar, actualizar, exportar bases de datos o gestionar usuarios, dar este paso te ayudar\u00e1 a construir un flujo m\u00e1s profesional y escalable. En definitiva, no se trata solo de ejecutar comandos: se trata de dise\u00f1ar tu propia capa de productividad sobre WordPress.<\/p>\n WP-CLI Handbook oficial<\/a><\/p>\n Referencia de comandos de WP-CLI en la documentaci\u00f3n de WordPress<\/a><\/p>\nQu\u00e9 es un comando personalizado en WP-CLI<\/h2>\n
Casos de uso habituales<\/h3>\n
C\u00f3mo funciona la extensi\u00f3n de wp-cli<\/h2>\n
Creando tu primer comando personalizado<\/h2>\n
<?php\nif (defined('WP_CLI') && WP_CLI) {\n\n \/**\n * Comando personalizado para WP-CLI.\n *\/\n class Mi_Comando_CLI {\n\n \/**\n * Ejecuta el comando.\n *\n * ## OPTIONS\n *\n * [--nombre=<texto>]\n * : Nombre a mostrar en la salida.\n *\n * ## EXAMPLES\n *\n * wp mi-comando saludar --nombre=Ana\n *\/\n public function saludar($args, $assoc_args) {\n $nombre = $assoc_args['nombre'] ?? 'mundo';\n\n WP_CLI::success(\"Hola, {$nombre}\");\n }\n }\n\n WP_CLI::add_command('mi-comando', 'Mi_Comando_CLI');\n}<\/code><\/pre>\nCu\u00e1ndo usar una clase y cu\u00e1ndo una funci\u00f3n<\/h3>\n
Organizaci\u00f3n del c\u00f3digo y buenas pr\u00e1cticas<\/h2>\n
Validaci\u00f3n y mensajes de salida<\/h3>\n
Registra comandos con intenci\u00f3n<\/h3>\n
C\u00f3mo integrarlo en un plugin o mu-plugin<\/h2>\n
Errores frecuentes al crear comandos personalizados<\/h2>\n
Conclusi\u00f3n<\/h2>\n
Fuentes y lecturas recomendadas<\/h3>\n