aPHP - Una especie de "plantilla de aplicaciones" para PHP

[dec]

Hola,

¡Qué exitazo, oigan! Jo, jo, jo...

[roman]

Hola David,

Yo ya bajé el código, vi un crédito totalmente injustificado e incluso lo "instalé". Pero es que la verdad no entiendo de qué va. Quizá si comentas un poco cuál sería la idea general, o incluir un ejemplo mínimo.

// Saludos

[[egostar]]

Yo ya lo baje también, pero han de perdonar mi ignorancia, como lo instalo, que necesito para instalarlo. Lo demás, pues ya roman lo ha expresado.

Salud OS.

[dec]

Hola,

¡Así que estáis ahí! Gracias, gracias.

Bueno. Es el caso que tengo que preparar aún el archivo "leeme", que ha de incluir información acerca de qué es y para qué puede servir aPHP... tal vez a alguien además de a un servidor, si es que al cabo termino haciendo algo "sobre" aPHP.

Y ahí está parte de la historia: aPHP no es "nada" de por sí... pretender servir como cimiento de alguna aplicación que realmente tenga alguna utilidad. En realidad quisiera opiniones respecto de dichos cimientos: no de ninguna aplicación, porque aPHP no es ninguna aplicación en concreto.

Pero de todos modos lleváis razón. De hecho quisiera preparar una aplicación a modo de ejemplo, con alguna utilidad, y que se base en aPHP. Ahora mismo lo que podéis descargar son los propios cimientos, o sea, ninguna aplicación en concreto.

¿Qué se puede hacer ahora mismo, tal cual está el asunto? ¿Qué podéis ver vosotros? ¿Cómo podéis verlo? Bueno. aPHP no precisa de ninguna instalación. Únicamente hemos de situar los archivos que se encuentran en el directorio "/www/" en el "htdocs" de nuestro Servidor Web.

Eso sí, es preciso que hagáis uso del archivo "/sql/aphp.sql", de modo que creéis en MySQL una base de datos que ahora mismo sólo contiene una tabla: base para los usuarios registrados en la supuesta aplicación que haga uso de aPHP. Esto sí es preciso: la base de datos ha de estar disponible.

A continuación tenéis que editar el archivo "/config.php". Son las cuatro o cinco primeras constantes que ahí se definen (está indicado en el archivo) las que tenéis que editar para que aPHP pueda utilizarse, para que podáis probarlo, vaya. Si necesitáis en este punto de alguna ayuda podéis comentarlo por aquí.

Ahora bien, una vez "instalado" aPHP... ¿qué se supone que podéis ver ahora mismo en funcionamiento? Ahora mismo hay disponibles cuatro extensiones o apartados en aPHP. Podéis comenzar por la URL de entrada principal, es decir:

http://localhost/aphp/

Supongiendo que "aphp" está en el directorio raíz del Servidor Web y que dentro del directorio "aphp" están contenidos los archivos que se encuentran en el directorio "/www/" que podéis encontrar entre los que descargáis.

Esa sería la URL principal, que se encarga de mostrar la portada de la aplicación. Podréis ver que es posible cambiar el lenguaje de la interfaz de la aplicación, así como el estilo de la misma: podréis ver, en definitiva, que "aPHP", aparentemente, funciona.

Otras URLs que podéis probar ahora mismo, correspondientes con extensiones (apartados) existentes ya en aPHP:

http://localhost/aphp/entrada

aPHP se encargará de imprimir el apartado de entrada a la aplicación, que presenta un formulario HTML desde el que podréis autenticaros como usuarios. Cuando creáis la base de datos (mediante el archivo "/sql/aphp.sql") se inserta el usuario "administrador" con la contraseña "administrador".

En este apartado se puede ver cómo trabajar con formularios en aPHP, cómo puede accederse a las variables de entrada, etc.

Otro apartado disponible se accede mediante la URL:

http://localhost/aphp/salida

Y este apartado se limita a "sacar" del sistema a un usuario previamente autenticado.

Existen también los apartados (o extensiones, mirad en el directorio "/ext/") "estilo" y "lenguaje", empero, estos no tienen salida alguna, sino que son Script que se usan para cambiar el estilo y el lenguaje de la interfaz de la aplicación.

Podréis comprobar que cualquier otra URL, es decir, por ejemplo:

http://localhost/aphp/roman

Os llevará al apartado de usuarios de la aplicación. Independientemente de que "roman" está registrado o no. Es el apartado "usuarios" (Script "/ext/usuarios.php") quien habría de saber qué hacer en caso de que "roman" no correspondiera a un usuario registrado en la aplicación.

Esto último significa que cada usuario registrado en la aplicación contará con su propia URL, por decirlo de algún modo. ¿Os acordáis de que en Loturak podía accederse a los apartados de los usuarios de este modo, más menos?

http://www.aplicacion.com/?usuario=roman

Pues bien, en aPHP la URL anterior se convierte en la siguiente:

http://www.aplicacion.com/roman

Pero no sé si debo seguir hablando y hablando sin parar... no quisiera aburrir a nadie. Efectivamente, tal vez debería haber "presentado" una aplicación real y en funcionamiento, y luego tal vez haber dicho "pues se basa en una cosa que se llama aPHP"...

Supongo que no pude aguantar más porque llevo un par de semanas (como mínimo) liado con este asunto... casi, casi, podría decirse que tenía necesidad de "sacarlo de mí", de dárselo a conocer a otros, y sobre todo a otros que pudieran decirme algo al respecto.

Bueno. No me enrollo más. Si necesitáis cualquier información comentadlo por aquí y veremos qué puede hacerse.

[dec]

Hola,

En pocas palabras... en definitiva, lo que podéis hacer (que no sería poco) es echar un vistazo al código fuente de aPHP. Tal vez sorprenderos con algo extraño o que no os parezca adecuado. Quizás comprobar cómo funciona aPHP "por dentro", hacer alguna que otra prueba... qué sé yo. He de reconocer que ahora mismo no se puede pedir más.

[semptrion]

Hola David:

Aquí estamos otra vez para darnos una mano en lo que se pueda. He revisado (muy de pasada por cierto) el código del aphp y ya he preparado algunos comentarios.

Respecto de la idea y de la consecución de ésta, te auguro el mejor de los éxitos.

Respecto de lo solicitado por ti, estas mis observaciones, en un plano general.

Observaciones de forma:

• No se muestran convenciones en la codificación.
  • Demasiadas deficiencias en cuanto a la longitud de las líneas, tanto en los comentarios como en el propio código
  • El uso del espacio en blanco es arbitrario.
  • La identación es aleatoria.
  • No existe una regla evidente para la apertura o cierre de llaves.
• El pronunciado uso del spanglish (p.e. un método llamado AddCabecera)
• No está especificada la versión del php.
• En los comentarios no existe el versionamiento (aunque la documentación muestra reglas claras y ha sido cuidadosamente elaborada, supongo que para utilizar phpDocumentor)
• Uso indistinto de comillas y apóstrofes para contantes literales.

Observaciones de fondo:

• (Diseño) La profunda dependencia con la estructura del sistema de archivos (p.e. header('Location: ../')) hace que necesariamiente el archivo se encuentre dependiente del directorio raíz en el entorno web!
• (Diseño) El manejo de errores es espontáneo y no sigue la codificación de errores del protocolo (http 1.0 ó http 1.1)
• (Seguridad) La salida de los programas es indefinida. Se utiliza la cláusula exit y debería(?) utilizarse die. Si es que el programa nada más hará.
• (Diseño) Existe una mezcla entre el código php y el código html
• (Diseño) Existe una dependencia de los atributos en el código html generado desde el php (p.e. captcha.class.php líneas 86 a 91)
• (Seguridad) Existe una separación entre los archivos de constantes de una clase y de la clase que usa esas constantes.
• (Diseño) Dependencia del motor de base de datos mysql (p.e LIMIT en consultas.inc.php)
• (Seguridad) Uso de cookies para la autenticación
• (Seguridad) Definición del modo desarrollo y modo producción mediante artilugios como saber si el servidor es localhost.
• (Diseño/Seguridad) La arbitrariedad en el uso de variables globales
• (Funcionamiento) No existe la posibilidad de portalizar las aplicaciones ni siquiera de incluirlas dentro de otras.
• (Seguridad) No existe la posibilidad de generar roles o diferentes niveles de acceso.
• (Seguridad) La configuración del archivo .htaccess puede tener resultados imprevistos en Windows, ya que usa cláusulas para linux (p.e. enlaces simbólicos). Habría que definir qué es lo que hace cada línea introducida en el .htaccess.
• (Seguridad) El archivo de configuración define parámetros, pero no especifica funcionamiento.

Al realizar las observaciones precedentes, no he pretendido revisar la lógica de los métodos (ni el diseño de las clases), sino empezar por algunas líneas base que permitirían el crecimiento del software y, por supuesto, su uso.

Entre las observaciones generales, quiero resaltar el tema de la construcción del código en sí. Si bien existe mucha preocupación por la documentacion, no encuentro preocupación por el mantenimiento del código; es decir, no se ven convenciones en la codificación que puedan ser utilizadas por otros programadores o por robots. En el tiempo, será más fácil reemplazar el código que entenderlo.

Esta situación se agrava por la mezcla entre el código php y el código html (y el código css y el código javascript) y el despliegue "inmediato" y oportunista. Si es invocado un método, éste desplegará datos, aún cuando luego deban ser (recién) enviados los encabezados.

Definir si los errores deben ser mostrados dependiendo de si es localhost resulta muy doméstico. Es mejor pensar en un modo de desarrollo y otro de producción, donde el modo es un estado del sistema y no una condición ni una situación.

La configuración establece los parámetros de funcionamiento del sistema, pero como un ente aislado de la propia configuracion del php, del apache y del sistema operativo. Así, el tema de la codificación, de la región o del magic quotes pueden afectar al funcionamiento, porque "variaron de lo que pensábamos", lo que resulta inadmisible en términos de un lanzador de aplicaciones o plantilla de aplicaciones.

Ahora, los demás temas (incluyendo el de la licencia Affero GPL o el del tema de las cookies) son totalmente tuyos y será una decisión que deberás cargar el resto del proyecto.

Sin embargo, creo que deberías revisar más el asunto de la reutilización de código que, de mejor manera (y con mejor licencia GPL) ha encarado temas como el manejo de mail. Te recomiendo des un paseo por http://pear.php.net o por http://pecl.php.net/ y que también revises http://framework.zend.com/

Para las convenciones, puedes adoptar alguna (como la de PEAR) o tomar ideas de otras (p.e. http://java.sun.com/docs/codeconv/).

Me siento inclinado a aplaudir el hecho que hayas previsto la posibilidad de tener una aplicación multiidioma; creo que estás en el momento de pensar en temas como el de la zona horaria y diferentes codificaciones (actualmente usas utf-8 para todo).

Finalmente, rescatar el hecho que tu código está en nuestro idioma. Sin embargo, EN LA MAYORÏA de los temas específicos ya se han hecho esfuerzos mucho más productivos (PEAR, PECL) que, si bien han producido comandos, éstos son como comandos con esteroides sin ton ni son. Ahí es donde tu concurso y esfuerzo puede ser mucho más enriquecedor: en establecer las reglas del juego para una plantilla de aplicaciones y su mejor empleo.

Saludos.

[dec]

Hola,

Agradezco tus comentarios semptrion. Los agradezco todos, aunque algunos no los llegue a entender bien.

Quisiera decir que bueno,... tal vez esta "cosa" no vaya a ir a ningún sitio. Si yo consiguiera escribir alguna aplicación basándome en ella... yo creo que podría darme con un canto en los dientes, como suele decirse.

Ahora bien, se trata de presentar lo que va hecho, de darlo a conocer, precisamente, para recibir todo tipo de críticas. Y eso es lo que has hecho y te lo agradezco otra vez.

Pero, chico, ¡parece haber tantos posibles problemas que no sé muy bien por dónde empezar, ni si, llegado el caso, merece la pena afrontar tantos problemas como parecen existir! ¡¡No valiera más comenzar de cero!!

Prometo revisar los puntos que refieres y si encuentro que tengo que añadir algo o decir algo al respecto lo comentaré por aquí. Para empezar voy a plantearme, más o menos seriamente, el uso de plantillas, de modo que evitemos el uso de PHP y HTML juntos (pero no revueltos, ¿o sí?).

No sé. Si se me ocurre algo más... lo diré. Pero muchas gracias por tus comentarios semptrion.