Cómo instalar Craft CMS en Ubuntu 18.04 LTS
Craft es un CMS de código abierto escrito en PHP. Craft te permite crear y gestionar fácilmente contenidos de gran apariencia, y diseñar y construir exactamente lo que necesitas. Es un CMS seguro y escalable con un gran ecosistema de plugins y el código fuente de Craft está alojado en GitHub. Este tutorial te guiará a través del procedimiento de instalación de Craft CMS en un servidor fresco de Ubuntu 18.04 LTS utilizando Nginx como servidor web y aseguraremos el sitio web con un certificado SSL de Let’s encrypt.
Requisitos
Craft requiere lo siguiente
- PHP versión 7.0 o superior con las siguientes extensiones PHP: (ctype, cURL, GD o ImageMagick, iconv, JSON, Multibyte String, OpenSSL, PCRE, PDO MySQL Driver o PDO PostgreSQL Driver, PDO, Reflection, SPL, Zip, Intl, DOM)
- MySQL 5.5+ con InnoDB, MariaDB 5.5+, o PostgreSQL 9.5+
- Al menos 256MB de memoria asignada a PHP
- Al menos 200MB de espacio libre en disco
Requisitos previos
- Un sistema operativo con Ubuntu 18.04
- Un usuario no root con privilegios sudo.
Pasos iniciales
Comprueba tu versión de Ubuntu:
lsb_release -ds
# Ubuntu 18.04.1 LTS
Configura la zona horaria:
sudo dpkg-reconfigure tzdata
Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque garantiza que tienes las últimas actualizaciones y correcciones de seguridad de los paquetes de software por defecto de tu sistema operativo:
sudo apt update && sudo apt upgrade -y
Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo Ubuntu:
sudo apt install -y curl wget vim git unzip socat
Paso 1 – Instalar PHP y las extensiones PHP necesarias
Instala PHP, así como las extensiones PHP necesarias:
sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-gd php-imagick php7.2-json php7.2-mbstring php7.2-mysql php7.2-pgsql php7.2-zip php7.2-intl php7.2-xml
Comprueba la versión de PHP:
php --version
# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies
Ejecuta sudo vim /etc/php/7.2/fpm/php.ini
y establece memory_limit
como mínimo 256MB
:
memory_limit = 256M
El servicio PHP-FPM se inicia y habilita automáticamente al reiniciar el sistema Ubuntu 18.04, por lo que no es necesario iniciarlo y habilitarlo manualmente. Podemos pasar al siguiente paso, que es la instalación y configuración de la base de datos.
Paso 2- Instalar MySQL/MariaDB y crear una base de datos
Craft CMS admite las bases de datos MySQL/MariaDB y PostgreSQL. En este tutorial, utilizaremos MySQL como servidor de base de datos.
Instala el servidor de bases de datos MySQL:
sudo apt install -y mysql-server
Comprueba la versión de MySQL:
mysql --version
# mysql Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using EditLine wrapper
Ejecutamysql_secure installation
script para mejorar la seguridad de MySQL y establecer la contraseña para elroot
usuario:
sudo mysql_secure_installation
Responde a cada una de las preguntas:
Would you like to setup VALIDATE PASSWORD plugin? N
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y
Conéctate al shell de MySQL como usuario root:
sudo mysql -u root -p
# Enter password
Crea una base de datos MySQL vacía y un usuario para Craft CMS y recuerda las credenciales:
mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;
Sal de MySQL:
mysql> exit
Sustituye dbname
, username
y password
por tus propios nombres.
Paso 3 - Instalar el clienteacme.sh
y obtener el certificado Let's Encrypt(opcional)
Asegurar tu sitio web con HTTPS no es necesario, pero es una buena práctica para asegurar el tráfico de tu sitio. Para obtener el certificado TLS de Let's Encrypt utilizaremos el cliente Acme.sh. Acme.sh es un software de shell unix puro para obtener certificados TLS de Let's Encrypt con cero dependencias.
Descarga e instala Acme.sh:
sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~
Comprueba la versión de Acme.sh:
/etc/letsencrypt/acme.sh --version
# v2.8.0
Obtén certificadosRSAyECC/ECDSApara tu dominio/nombre de host:
# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048
# ECDSA
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256
Después de ejecutar los comandos anteriores, tuscertificadosyclavesestarán en:
- ParaRSA: directorio
/etc/letsencrypt/example.com
. - ParaECC/ECDSA: directorio
/etc/letsencrypt/example.com_ecc
.
Paso 4 - Instalar y configurar Nginx
Craft CMS puede funcionar bien con muchos softwares de servidores web populares. En este tutorial, hemos seleccionado Nginx.
Descarga e instala la última versión principal de Nginx desde el repositorio oficial de Nginx.
Empieza por descargar la clave PGP del repositorio de Nginx:
wget https://nginx.org/keys/nginx_signing.key
Añade la clave al llavero del programaapt
:
sudo apt-key add nginx_signing.key
Añade y configura el repositorio APT de la línea principal de Nginx:
sudo -s
printf "deb https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
Actualiza la lista de repositorios:
sudo apt update
Instala los últimos paquetes de Nginx mainline:
sudo apt install -y nginx nginx-module-geoip nginx-module-image-filter nginx-module-njs nginx-module-perl nginx-module-xslt
Iniciar y activar el servicio Nginx:
sudo systemctl start nginx.service
sudo systemctl enable nginx.service
Comprobar la versión de Nginx:
sudo nginx -v
# nginx version: nginx/1.15.8
Configura Nginx para Craft CMS ejecutando:
sudo vim /etc/nginx/conf.d/craft.conf
Y rellena el archivo con la siguiente configuración:
server {
listen 80;
listen [::]:80;
listen 443 ssl;
listen [::]:443 ssl;
server_name example.com www.example.com;
root /var/www/craft/web;
index index.php;
ssl_certificate /etc/letsencrypt/example.com/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/example.com/example.com.key;
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;
location / {
try_files $uri/index.html $uri $uri/ /index.php?$query_string;
}
location ~ [^/]\.php(/|$) {
try_files $uri $uri/ /index.php?$query_string;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param HTTP_PROXY "";
}
}
NOTA: Para ver la configuración completa y lista para producción de Nginx para Craft, visitahttps://github.com/nystudio107/nginx-craft. La configuración se ha simplificado intencionadamente para que sea densa y sencilla.
Abre el archivo nginx.conf
y establece user
en www-data
.
sudo vim /etc/nginx/nginx.conf
user www-data www-data;
Prueba la configuración de Nginx:
sudo nginx -t
Recarga Nginx:
sudo systemctl reload nginx.service
Paso 5 - Instalar Composer
Instala Composer, el gestor de dependencias de PHP de forma global:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
Comprueba la versión de Composer:
composer --version
# Composer version 1.8.0 2018-12-03 10:31:16
NOTA:Los comandos de instalación de Composer cambiarán en el futuro, así que comprueba en https://getcomposer.org/download/los comandos más actualizados si los anteriores no funcionan.
Paso 6 - Instalar Craft CMS
Craft CMS se puede descargar con Composer o descargando manualmente un archivo .zip
o tar.gz
. En este tutorial utilizaremos Composer para descargar Craft CMS.
Crea un directorio raíz de documentos en el que debería residir Craft CMS:
sudo mkdir -p /var/www/craft
Navega hasta el directorio raíz del documento:
cd /var/www/craft
Cambia la propiedad del directorio/var/www/craft
ajohndoe
.
sudo chown -R [your_username]:[your_username] /var/www/craft
Para crear un nuevo proyecto Craft, ejecuta este comando:
composer create-project craftcms/craft .
Cambia la propiedad del directorio/var/www/craft
awww-data:
sudo chown -R www-data:www-data /var/www/craft
En tu navegador web, ve ahttp://<Hostname>/index.php?p=admin/install
(sustituyendo<Hostname>
por el nombre de host de tu servidor web). Si has hecho todo bien hasta ahora, deberías ser recibido por el Asistente de Configuración de Craft.
Paso 7 - Completar la instalación de Craft CMS
Después de abrir tu URL de instalación debería aparecer la página como la siguiente. Haz clic en el botón"Instalar Craft":
Acepta la licencia haciendo clic en el botón "Lo tengo ":
Rellena los detalles de la base de datos y haz clic en el botón "Siguiente ":
Crea la cuenta de Craft y haz clic en el botón " Siguiente ":
Configura tu sitio y haz clic en el botón " Finalizar ":
Después de esto deberías ser redirigido a la página de administración de Craft: