En orden de instalar Propel usted necesita:
Propel puede ser usado en ambas plataformas Unix y Windows.
Propel está disponible en formato "tradicional" tarball y desde la version 1.0.0 está también disponible como in paquete instalable PEAR. La opción tarball da más flexibilidad, pero es más es más difícil de instalar. La opción PEAR es perfecta si desea tomarlo y hacerlo funcionar rapidamente, pero es más "magico" y desde aquí curva de aprendizaje para personalizaciones es más paso a paso.
Ahora es posible instalar ambos el generador Propel y el ejecutor de componentes como paquetes PEAR. Esta es lejanamente la forma más fácil de poner a correr Propel, pero puede no ser completamente tan fácil de configurar como con la instalación tradicional. Estos paquetes actualmente no dependen uno del otro, por ello usted puede instalar sólo el generador o sólo el ejecutor de clases. Note que el ejecutor de clases depende del paquete Creole.
$> instalación pear http://propel.phpdb.org/pear/propel_generator-current.tgz
El paquete generador viene con un conveniente script propel-gen shell el cual actualmente puede usar para automaticamente construir el proyecto.
$> propel-gen /dirección/de/su/directorio/proyecto [objetivo]
Como puede ver en el ejemplo, usted debe crear un directorio proyecto. Usted puede hechar un vistazo al ejemplo provisto bookstore directorio del proyecto (en su directorio de datos PEAR). Este tópico está también cubierto con más detalle en el siguiente capitulo, Iniciandose.
Las clases de ejecución son instaladas de la misma manera como las clases generador.
$> pear install http://propel.phpdb.org/pear/propel_runtime-current.tgz
Configuraciones nuevas no son necesarias (asumiendo que su directorio PEAR php este en su include_path).
Lo ha hecho. leyendo la instalación tradicional es probablemente una buena idea de cualquier forma, especialmente como la mayoría de los ejemplos fueron escritos para propel instalado de la forma tradicional.
Con el fin de simplificar este capitulo haremos algunas suposiciones acerca de la localización de los archivos. Asumiremos que su inmstalación probablemente difiera, entonces estos deverían servir sólo como una referencia para las siguientes instrucciones
ruta | Unix (Linux, FreeBSD, etc.) | Windows |
---|---|---|
ejecutor Propel | /usr/local/propel/runtime | C:\PHP\apps\propel\runtime |
generador Propel | /usr/local/propel/generator | C:\PHP\apps\propel\generator |
librerías PEAR | /usr/local/lib/php | C:\PHP\PEAR |
Usted puede instalar Propel desde un paquete liberado (distribución imagen) o desde un CVS. Instalando desde una liberación o imagen siempre sera más simple, pero si quiere mantener y (esperamos que sea asi!) ayudar a los desarrolladores de Propel, entonces debería revisar una copia de las funetes desde un CVS.
Si usted obtiene un tar.gz o .zip de Propel, entonces simplemente descomprima el archivo y mueva la carpeta resultante a la posición correcta. Por ejemplo:
$> cd /usr/local $> tar zxvf propel-x.x.x.tar.gz $> ln -s propel-x.x.x propel
Instalando desde un CVS lo asegura de tener el código fuente más actualizado. (desde luego el código desde CVS no es estable y no debería ser utilizado en producción.)
Nota: el modulo propel en CVS tiene una lijera diferencia estructura de directorios debido a consideraciones legales y limitaciones impuestas por tigris.org. Notablemente, todos los "modulos" se encuentran actualmente en un nivel alto de directorios propel; también las clases de ejecución estan en los subdirectorios de propel, mientras el componente generados está en el directorio generador-propel. Revise el siguiente ejemplo (Unix) usando las suposiciones de ruta que definimos a continuación:
$> cvs -d :pserver:guest@cvs.tigris.org:/cvs login Password: [guest] $> cvs -d :pserver:guest@cvs.tigris.org:/cvs checkout propel $> mkdir /usr/local/propel $> mv propel/propel /usr/local/propel/runtime $> mv propel/propel-generator /usr/local/propel/generator
Para los usuarios de Windows, hay un número gráfico de clientes CVS disponibles como el muy capaz y fácil de usarTortoiseCVS.
Una vez ha desempacado su distribución Propel, necesitara configurar su ambiente PHP.
Necesita adicionar el directorio propel/runtime/classes a su PHP include path. Note que usted solamente necesita adicionar las clases de ejecución a su include_path, como el proceso de construcción calcula el include_path para el generador de clases automaticamente. En ese orden de palabras, este paso no es requarido para construir su modelo de objeto, pero es requerido actualmente usa su código generado desde un script PHP. El camino má fácil y más permanente de ajustar su include_path es simplemente modificando su archivo php.ini y adicionando este directorio a la variable include_path :
# Unix include_path="/usr/local/lib/php:/usr/local/propel/classes" ; Windows include_path="C:\PHP\PEAR;C:\PHP\apps\propel\classes"
Si no posee permisos sobre el archivo php.ini y no puede especificar el valor include_path en su archivo .htaccess usted siempre podra hacer esto al ejecutor mediante scripts PHP:
<?php set_include_path("/usr/local/propel/runtime/classes:" . get_include_path()); require_once 'propel/Propel.php'; Propel::init( MY_CONF_DIR . '/propel/runtime-conf.php');
Ahora el ambiente de ejecución de Propel esta listo para ser usado en su modelo objeto. como aprendera en las subsecuentes secciones, también necesitara el include_path para account para su modelo de objeto de clases PHP ( ej. las clases que el generador de propel construye para usted).
También debería revisar que los siguientes ajustes PHP INI settings sean corectos:
Variable | Valor |
---|---|
ze1_compatibility_mode | Off |
magic_quotes_gpc |
Off |
magic_quotes_sybase |
Off |
register_globals |
Off (esto actualmente no afecta a Propel, pero es importante anotar que en Propel no necesita estar activo 'On') |
Estos deben ser los valores por defecto para estas opciones. También, no hay requerimientos que registros globales sean puestos en 'off', pero es una buena idea -- e importante, Propel no requiere que este en 'on'.
Hasta este punto debería terminar la instalación y ajuste de Propel. Para estar seguro de que todo funciona bien, continue con el capitulo Iniciándose/a>para caminar a través de ejmplos.