MiCode Manager

La espera ha terminado.  Ya está publicada la primera versión funcional completa de  miCode Manager . Esta versión fue desarrollada sin hacer uso de bases de datos, por lo que prácticamente solo se requiere tener instalado PHP para poder usarlo (8.1 o superior, preferiblemente). Eso y asignar los respectivos permisos para que se puedan crear y modificar archivos desde el aplicativo. En caso que sea la primera vez que escuchas de este proyecto, te invito a visitar la  presentación  que hice hace algunos meses para que estés al tanto del qué, cómo y el porqué. El “para qué” se ilustra con este  caso de uso  publicado anteriormente. Respecto al “cuándo”, la respuesta es “ahora” y sobre eso trata esta entrada del blog. ¿Cómo comenzar? Para usar miCode Manager  primero descarga una copia del código publicado en Github  o puedes también  clonar el repositorio. Asegúrate de copiar los archivos en un directorio del servidor web en tu...

Continuando con esta serie de instalación de herramientas para desarrollo web sobre Windows, continuamos con la instalación y puesta en marcha de PHP sobre un servidor Apache. ¡¿Queeeeeeeeeeeeeeeeee??! Seguro esa será la reacción de muchos. En un mundo donde los frameworks basados en Javascript proliferan ( NodeJS , React , NextJS por citar algunos ejemplos), ¿porqué invertir tiempo en PHP , ese “dinosaurio” de los lenguajes de programación para Web? Bueno, hay varias razones: Es un lenguaje fácil de aprender, instalar y poner en marcha. Tiene una amplia documentación en su página y en diferentes idiomas, como el español ( https://www.php.net/manual/es/ ). Wordpress es una de las herramientas para manejo de contenido de mayor uso en la Web y está desarrollada sobre PHP. Cierra el top 10 de las tecnologías más populares en la encuesta de servicios de StackOverflow 2022 ( https://survey.stackoverflow.co/2022/ ). Sigue siendo de lejos una herramienta estable que se mantiene en conti...

Actualmente el estándar en Internet es que todo, absolutamente todo, deba consultarse usando el protocolo HTTPS , lo que “garantiza” que la información que se transmite desde el navegador hasta el servidor web viaja encriptada y solamente el servidor “entiende” lo que el cliente envió. Para quienes no están convencidos y para evitarles el trabajo de ir a buscarlo, esta es la definición de HTTPS tomado de Wikipedia: El Protocolo seguro de transferencia de hipertexto (en inglés, Hypertext Transfer Protocol Secure o HTTPS ) es un protocolo de aplicación basado en el protocolo HTTP, destinado a la transferencia segura de datos de hipertexto, es decir, es la versión segura de HTTP. https://es.wikipedia.org/wiki/Protocolo_seguro_de_transferencia_de_hipertexto Como desarrolladores, hay que anotar que en lo que a consultas locales se refiere, se “asume” que uno mismo no requiere tanto protocolo y por tanto todo el desarrollo a realizar podría hacerse sobre HTTP convencional. Sin embargo,...

Todo programador o aspirante a programador de aplicaciones/páginas Web debería realizar sus desarrollos en un computador local, ya sea por comodidad tranquilidad, velocidad o para evitar los inconvenientes causados cuando la red o Internet fallan. Para eso, necesita contar con las herramientas básicas para su desarrollo, entre ellas: Un editor de código . Visual Studio Code o VSCode de Microsoft ( https://code.visualstudio.com/ ) es bastante recomendado. Si se requiere algo mucho más lite pero funcional, que pueda cargarse fácilmente en una USB por ejemplo, el editor Scite está disponible en la web ( https://scintilla.org/SciTE.html ). Servidor Web . Este puede ser Internet Information Server , disponible en muchos equipos con Microsoft Windows. Pero si el desarrollo final correrá sobre un servidor Linux, recomendaría usar un servidor web Apache. Ahora bien, si no tienes tiempo para uno u otro y programas sobre PHP , este tiene un servidor web embebido que puede usarse sin problema...

En esta entrada se presenta un ejemplo básico de cómo poder usar miCode Manager en un entorno funcional. Por cierto, si esta es la primera vez que lees sobre este proyecto, quizás quieras conocer un poco más en la publicación donde con los detalles de operación y manejo de miCode Manager Versión 1.0 . Para comenzar, consideraremos el siguiente escenario: Eres un desarrollador que se adiciona a un proyecto en curso, ya sea como freelance o como empleado de la empresa que requiere el desarrollo (empresa contratante). Como se ha expresado anteriormente, miCode no es (ni pretende ser) un repositorio de control de cambios, por tanto debería apoyarse en un software que haga las veces de uno, como GitHub , Bitbucket o cualquier otro sistema de control de versiones. Por tanto, la empresa contratante contará con un repositorio de control de cambios desde donde puedan descargarse los siguientes paquetes: miCode Manager (para referencia, su repositorio oficial está en  https://githu...

Una de las funciones a incluir en miCode fue la de explorar el directorio de un proyecto. Así que hice lo mismo que todos, busque en la web alguna librería para explorar directorios vía web pero las que encontré eran demasiado “sofisticadas” y completas para lo que necesitaba, que era básicamente la posibilidad de navegar un directorio, sin necesidad de editar, eliminar o adicionar archivos por web, a fin de cuentas que en mi caso, lo que necesitaba era solamente explorar un directorio de proyecto como ayuda en la gestión del mismo, el usuario debe estar en capacidad de poder hacer las modificaciones directamente en el computador. Así que al no encontrar alguna librería “ light ” para realizar la exploración de directorios, escribí una propia para incluirla en los repositorios de miCode . El resultado es la librería miframe-explorer , que ya se encuentra publicada en GitHub   El código básico para su uso es el siguiente: $explorer = new \miFrame\Utils\Explorer(); echo $...

Uno de los grandes dolores de cabeza que tuve al programar fue el no poder acceder en línea a la documentación del código y como tal, poca importancia se le dio a la documentación efectiva del mismo. Como resultado, la revisión de código resultaba un completo martirio cuando no recordabas los detalles de alguna clase o función o no tenías a mano al programador que lo escribió para explicarlo. DocSimple es una clase PHP que se encarga de leer un script e intenta recuperar la documentación del mismo, siempre que esta se haga siguiendo las directrices del modelo Javadoc, adaptado según se describe en la página de la librería phpDocumentor . Por ejemplo: /** * Primera línea es un resumen de mifunction_php. * A continuación la descripción. Cada párrafo termina en punto o con una * línea en blanco. * @param string $argument1 Esta es la descripción del primer argumento. * @return string Texto de salida. */ function mifunction_php(string $argument1) { … return $text; } Aunque por defe...