Cmo instalar y configurar Apache, PHP, MySQL y phpMyAdmin en OS X 10.

9 Mavericks
S eres desarrollador web y necesitas tener Apache, PHP y MySQL funcionando en tu nuevo sistema operativo OS X Mavericks, esta gua te va a ayudar a instalarlo y configurarlo. Tambin s que existen herramientas que incluyen todo el paquete configurado cmo MAMP y XAMP pero lo cierto es que yo prefiero instalar todo desde cero para evitar problemas a la hora de querer actualizar o instalar extensiones de PHP, cmo por ejemplo la extensin Intl que se requiere para trabajar con Symfony. Si haz actualizado desde Mac OS X 10.8 Mountain Lion y tenas ya todo configurado, tu MySQL, Apache y la configuracin de phpMyAdmin deben seguir funcionando sin problema, ahora slo tienes que activar PHP. Pero si haz hecho una instalacin limpia de OS X Mavericks sigue todos los pasos. Para tener tu servidor local de desarrollo con Apache, PHP y MySQL vas a dividir esta gua en estos pasos: 1. Habilitar Apache 2. Configurar el DocumentRoot en Apache 3. Configurar los .htaccess para que permitan sobreescribir 4. Habilitar PHP 5. Instalar y configurar MySQL

1. Habilitar Apache

6. Instalar phpMyAdmin 7. Configurar permisos

Apache est preinstalado en el sistema operativo y solamente le falta ser activado a travs de la lnea de comandos, esto se hace desde la aplicacin llamada Terminal que se encuentra en /Applications/ Utilities/Terminal Para aquellos no familiarizados con la Terminal, en realidad no es tan complicado como puede parecer, una vez que abras la Terminal tienes una ventana lista para que escribas los comandos, puedes solamente copiar y pegar los comandos aqu mencionados y presionar Enter, algunos comandos no dan respuesta, slo significa que el comando se llev a cabo, otros comandos dan informacin, etc. Pasemos a la accin. Para iniciar Apache escribe este comando en la Terminal: sudo apachectl start Despus de poner este comando te va a pedir la contrasea de administrador, esto es porque estamos usando el comando sudo para ejecutar apache con permisos de administrador. Ahora cuando quieras apagar Apache usa este comando: sudo apachectl stop Para reiniciar Apache

sudo apachectl restart Para mostrar la versin actual de Apache httpd -v La versin de Apache instalada en OS X Mavericks es la Apache/2.2.24 Despus de iniciar Apache, prueba desde el navegador que el servidor web est funcionando, escribe la direccin http://localhost y debers ver en tu navegador el texto: It works!.

2. Configurar el DocumentRoot en Apache

El DocumentRoot (directorio raz) es el lugar donde se almacenan los archivos que nuestro servidor va a compartir, es el equivalente a los public_html y htdocs, OS X ha tenido histricamente 2 directorios raz, uno a nivel de sistema y otro a nivel de usuario, puedes usar ambos o solamente trabajar con uno, la ventaja del de nivel de usuario es que permite que cada usuario tenga su propia carpeta raz, mientras que el que est a nivel sistema es global para todos los usuarios. Adems al usar el de nivel de usuario evitar que tengas que escribir la contrasea de administrador cada vez que quieras hacer

una modificacin a los archivos dentro de la carpeta raz. La ruta de la carpeta raz a nivel de sistema es la siguiente: /Library/WebServer/Documents/ Mientras que la carpeta raz a nivel de usuario puede ser la que tu quieras, pero tradicionalmente en OS X se usa la siguiente /Users/tu usuario/Sites Cmo configurar la carpeta raz a nivel de usuario La otra carpeta raz que no se encuentra de manera predeterminada es la carpeta ~/Sites dentro de la carpeta de usuario. Es necesario crear una carpeta llamada Sites en la raz de tu carpeta de usuario, en mi caso mi isiario es carlos por lo tanto la raz de mi carpeta de usuario es /Users/carlos/. Si ests actualizando a OS X Mavericks desde una versin anterior de OS X, se preserva la carpeta Sites, pero se elimina la configuracin que haca que fuera la carpeta raz. No te preocupes, sigue estos pasos para configurar Sites como la carpeta raz (DocumentRoot). Para esto se necesita aadir un archivo con el nombre carlos.confdonde carlos es el nombre de usuario de tu cuenta en OS X, en mi caso carlos, a continuacin te digo como crearlo.

Primero verifica que no tengas un el archivo carlos.conf en la siguiente ruta con el comando: cd /etc/apache2/users ls Si no hay un archivo llamado carlos.confcrealo, para eso vamos a usar un editor de texto desde la Terminal llamado nano, ejecuta el siguiente comando (recuerda reempazar carlos por tu nombre de usuario): sudo nano carlos.conf Agregar este cdigo dentro del archivo recin creado, recuerda reempazar carlos por tu nombre de usuario. <Directory "/Users/carlos/Sites/"> Options Indexes MultiViews AllowOverride All Order allow,deny Allow from all </Directory> Despus de pegar el cdigo en nano presiona ctrl + o y luego Enter para guardar y luego ctrl + x para cerrar

nano. Ahora cambia los permisos al archivo con este comando (recuerda reempazar carlos por tu nombre de usuario): sudo chmod 644 username.conf Finalmente reinicia Apache para que los cambien tengan efecto, con este comando: sudo apachectl restart Ahora el contenido de Sites es accesible desde la URL: http://localhost/~carlos/

3. Configurar los .htaccess para que permitan sobreescribir

Por default Apache tiene desahibitada la posibilidad de usar nuestros .htaccess para sobre escribir las configuraciones por defecto, para corregir esto vamos a editar el archivo httpd.conf ubicado en: /etc/ apache2/httpd.conf lo abrimos y buscamos la lnea 217 que dice AllowOverride none y lo cambiamos por AllowOverride all

Finalmente reinicia Apache para que los cambien tengan

efecto, con este comando: sudo apachectl restart

4. Habilitar PHP

OS X Mavericks viene con PHP 5.4.17 pero para que funcione debe ser activado editando el archivo httpd.conf. sudo nano /etc/apache2/httpd.conf Utiliza ctrl + w para buscar dentro de nano y la busca php este esto te llevar a la lnea que contiene lo siguiente pero que est comentada con un # al inico de la lnea, para descomentar simplemente elimina el # al inicio de la lnea para que quede con la siguiente: LoadModule php5_module libexec/apache2/ libphp5.so Para finalizar ctrl + o y luego Enter para guardar y luego ctrl + x para cerrar nano. Reinicia Apache para que los cambien tengan efecto, con este comando: sudo apachectl restart Para ver y probar PHP, crea un archivo llamado phpinfo.php y colcalo en la carpeta Sites con el siguiente contenido, y luego mralo en el navegador. <php phpinfo(); ?>

5. Instalar y configurar MySQL

MySQL es un componente que OS X ya no incluye de serie como antes, ahora es necesario descargarlo desde el sitio de MySQL (Sitio para descargar MySQL), en el sitio de descarga elige la versin llamada Mac OS X 10.7 (x86, 64-bit), DMG Archive esta versin funciona bien en OS X Mavericks. Al descargar MySQL no tienes que registrarte, buscar al final de la pgina de descarga el enlace que dice: No thanks, just take me to the downloads para pasar directamente a la descarga sin registro. Una vez descargado MySQL abre el .dmg y vers 3 componentes, instala los 3. Es posible que necesites ajustar las preferencias de seguridad y privacidad de OS X para permitir instalaciones de aplicaciones de terceros, en caso de que no te deje instalarlo ve a Preferencias del sistema -> Seguridad y privacidad y ah marca la opcin que dice Permitir aplicacin descargadas de: -> Cualquier sitio.

Primero instala mysql-5.x.x, luego MySQLStartupItem.pkg que permite iniciar MySQL cuando la Mac se inicia y el tercero es una preferencia del sistema que permite iniciar y/o detener MySQL. Puedes iniciar el servidor MySQL desde las Preferencias

del sistema o a travs de la Terminal.

Comando para iniciar MySQL sudo /usr/local/mysql/support-files/ mysql.server start Comando para ver la versin de MySQL desde la Terminal: /usr/local/mysql/bin/mysql -v Despus de la instalacin, con el fin de utilizar los comandos de MySQL en la Terminal sin tener que escribir la ruta completa hacia los comandos. Vamos a agregar el directorio mysql a tu shell path, (paso opcional) esto se hace en el archivo .bash_profile que est en tu carpeta de usuario, si no tienes ese archivo slo cralo con vi o nano con este comando: cd ; nano .bash_profile

Y pega esta lnea dentro del archivo: export PATH="/usr/local/mysql/bin:$PATH" Ahora ctrl + o y luego Enter para guardar y luego ctrl + x para cerrar nano. La ltima cosa que hay que hacer aqu es para recargar la shell para que todo funcione, con el siguiente comando: source ~/.bash_profile Ahora prueba el con el comando: mysql -v Si todo sali bien te debe mostrar la versin de MySQL, ahora solamente presiona \q para salir de MySQL. Configurar la contrasea root de MySQL Es importante que sepas que la contrasea del usuario root de MySQL no es la misma que se usa como admin en OS X, algunas personas la confunden, la contrasea para el usuario root es una contrasea que te permitir gestionar MySQL. Para asignar la contrasea al usuario root usa el siguiente comando (recuerda reemplazar aqu_va_tu_contrasea por la contrasea que quiere utilizar): /usr/local/mysql/bin/mysqladmin -u root password 'aqu_va_tu_contrasea'

Usa comillas simples entre la contrasea

6. Instalar phpMyAdmin
Antes de instalar phpMyAdmin tal vez desees darle un vistazo a Sequel Pro es una apliacin gratuita que te permite gestionar MySQL en una interfaz amigable y fcil de usar, ltimamente la he usado ms que phpMyAdmin, pgina de descarga de Sequel Pro. Para instalar phpMyAdmin primero debes ejecutar estos comando para corregir el mysql 2002 socket error: sudo mkdir /var/mysql sudo ln -s /tmp/mysql.sock /var/mysql/ mysql.sock Descarga phpMyAdmin, en un archivo .zip y descomprmelo y nombra a la carpeta phpmyadminluego mueve esa carpeta y colcala dentro de la carpeta Sites (la carpeta raz). Ahora vamos a crear la carpeta config con este comando: mkdir ~/Sites/phpmyadmin/config Cambia los permisos de la carpeta con este comando: chmod o+w ~/Sites/phpmyadmin/config Ejecuta la instalacin de phpMyAdmin desde el navegador ve a la direccin: http://localhost/~carlos/phpmyadmin/ setup/ (recuerda reemplzar carlos con tu nombre de

usuario) o http://localhost/phpmyadmin/setup/ Es necesario crear una nueva conexin de servidor MySQL para localhost, haz clic en New server.

Cambia a la pestaa Authentication y configura el usuario cmo root la contrasea.

Aade el nombre de usuario root (tal vez ya estaba rellenado, aade la contrasea que configuraste anteriormente para el usuario root de al instalar MySQL, haz clic en Save y volvers a la pantalla anterior.

Asegrate de hacer clic en Save, esto crear un archivo llamado config.inc.php en la carpeta config dentro de la carpeta de phpmyadmin, ahora tienes que mover este archivo a la raz de phpmyadmin y despus eliminar el directorio config ahora vaco. Ahora ya puedes acceder a phpMyAdmin desde tu navegador: http://localhost/~carlos/phpmyadmin/ (recuerda reemplzar carlos con tu nombre de usuario) o http://localhost/phpmyadmin/

7. Configurar permisos
Para ejecutar un sitio web sin problemas de permisos, es mejor establecer la raz Web y su contenido para ser escribible por todos, ya que es un desarrollo local, esto no debera ser un problema de seguridad. Digamos que tienes un sitio en la carpeta Sites en el siguiente lugar ~/Sites/sitio-de-prueba para hacerlo escribible ejecuta el siguiente comando: sudo chmod -R a+w ~/Sites/sitio-de-prueba Si ests preocupado por la seguridad entonces en vez de la carpeta sea escribible por todo el mundo, ajusta el usuario para que sea Apache _www pero cuando se trabaja con archivos debers autenticarte como administrador ya que no eres el propietario, el comando para hacer que sean escribibles por Apache es el siguiente: sudo chown -R _www ~/Sites/sitio-de-prueba Esto establecer el contenido de forma recursiva a ser propiedad del usuario de Apache. Si tuvieras la pgina web almacenada en el directorio raz a nivel del sistema en /Library/WebServer/ Documents/sitio-de-prueba entonces tendras que usar este comando ste: sudo chown -R _www /Library/WebServer/ Documents/sitio-de-prueba As que creo que vale la pena la creacin de la carpeta raz a nivel de usuario ya que hay menos problemas de

autenticacin.

Eso es todo! Ahora tienes tu AMP (Apache, MySQL y PHP) nativo que se ejecuta sobre el nuevo sistema OS X Mavericks. Ahora solamente queda pendiente para otra gua sobre cmo configurar Virtual Hosts en Apache sobre OS X Mavericks y Mountain Lion (aunque tambin puedes usar una utilidad llamada VirtualHostX que te permite configurar los Virtual Hosts en Apache de manera visual) y no te puedes perder estas otras guas: Cmo instalar PEAR y PECL en OS X Mavericks Cmo instalar la extensin intl de PHP en OS X Mavericks Cmo instalar APC (Alternative PHP Cache) en OS X Mavericks