Com instal·lar ProcessWire CMS 3.0 en un FreeBSD 11 FAMP VPS

ProcessWire CMS 3.0 és un sistema de gestió de continguts (CMS) senzill, flexible i potent, gratuït i de codi obert. ProcessWire CMS 3.0 inclou una API d'estil jQuery fàcil d'utilitzar, una arquitectura de complements totalment modular i un sistema de plantilles flexible i potent que ofereix una experiència d'usuari igualment satisfactòria per a dissenyadors, desenvolupadors i usuaris finals.

En aquest tutorial, instal·larem ProcessWire CMS 3.0 en un VPS FreeBSD 11 FAMP mitjançant el servidor web Apache, PHP 7.1 i una base de dades MariaDB.

Requisits previs

• Una instància neta del servidor Vultr FreeBSD 11 amb accés SSH

Pas 1: afegiu un usuari de Sudo

Començarem afegint un nou sudousuari.

Primer, inicieu sessió al vostre servidor com a root:

ssh root@YOUR_VULTR_IP_ADDRESS

L' sudoordre no s'instal·la per defecte a la instància del servidor Vultr FreeBSD 11, de manera que primer instal·larem sudo:

pkg install sudo

Afegeix un usuari nou anomenat user1(o el teu nom d'usuari preferit):

adduser user1

L' adduserordre us demanarà molts detalls per al compte d'usuari, així que simplement seleccioneu els valors predeterminats per a la majoria d'ells quan tingui sentit fer-ho. Quan se us demani si voleu Invite user1 into any other groups?, heu d'entrar wheelper afegir user1-lo al wheelgrup.

Ara comproveu el /etc/sudoersfitxer per assegurar-vos que el sudoersgrup estigui habilitat:

visudo

Busca una secció com aquesta:

# %wheel        ALL=(ALL)       ALL

Aquesta línia ens indica que els usuaris que són membres del wheelgrup poden utilitzar l' sudoordre per obtenir rootprivilegis. Es comentarà de manera predeterminada, de manera que haureu de deixar-lo de comentar i després desar i sortir del fitxer.

Podem verificar la user1pertinença al grup amb l' groupsordre:

groups user1

Si user1no wheelsou membre del grup, podeu utilitzar aquesta ordre per actualitzar la user1pertinença al grup:

pw group mod wheel -m user1 

Ara utilitzeu l' suordre per canviar al nou user1compte d' usuari sudo :

su - user1

L'indicador d'ordres s'actualitzarà per indicar que ara heu iniciat sessió al user1compte. Podeu comprovar-ho amb l' whoamiordre:

whoami

Ara reinicieu el sshdservei perquè pugueu iniciar sessió sshamb el nou compte d'usuari sudo no root que acabeu de crear:

sudo /etc/rc.d/sshd restart

Sortiu del user1compte:

exit

Sortiu del rootcompte (que desconnectarà la vostra sshsessió):

exit

Ara podeu accedir ssha la instància del servidor des del vostre amfitrió local mitjançant el nou user1compte d' usuari sudo no root :

ssh user1@YOUR_VULTR_IP_ADDRESS

Si voleu executar sudosense haver d'escriure una contrasenya cada cop, torneu a obrir el /etc/sudoersfitxer amb visudo:

sudo visudo

Editeu la secció del wheelgrup perquè quedi així:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Tingueu en compte: desactivar el requisit de contrasenya per a l'usuari sudo no és una pràctica recomanada, però s'inclou aquí, ja que pot fer que la configuració del servidor sigui molt més còmoda i menys frustrant, especialment durant sessions d'administració de sistemes més llargues. Si us preocupen les implicacions de seguretat, sempre podeu revertir el canvi de configuració a l'original després d'haver acabat les tasques d'administració.

Sempre que vulgueu iniciar sessió al rootcompte d'usuari des del sudocompte d'usuari, podeu utilitzar una de les ordres següents:

sudo -i
sudo su -

Podeu sortir del rootcompte i tornar al vostre sudocompte d'usuari en qualsevol moment simplement escrivint exit.

Pas 2: actualitzeu el sistema FreeBSD 11

Abans d'instal·lar qualsevol paquet a la instància del servidor FreeBSD, primer actualitzarem el sistema.

Assegureu-vos que heu iniciat sessió al servidor amb un usuari sudo que no sigui root i executeu les ordres següents:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Pas 3: instal·leu el servidor web Apache

Instal·leu el servidor web Apache 2.4:

sudo pkg install apache24

I entreu yquan se us demani. Ara feu servir l' sysrcordre per permetre que el servei Apache s'executi automàticament en el moment de l'arrencada:

sudo sysrc apache24_enable=yes

L' sysrcordre actualitza el /etc/rc.conffitxer de configuració, de manera que si voleu verificar l'actualització de configuració manualment, simplement podeu obrir el /etc/rc.conffitxer amb el vostre editor de terminal preferit:

vi /etc/rc.conf

Ara inicieu el servei Apache:

sudo service apache24 start

Podeu comprovar ràpidament que Apache s'està executant visitant l'adreça IP o el domini de la instància del servidor al vostre navegador:

http://YOUR_VULTR_IP_ADDRESS/

Veureu la pàgina predeterminada de FreeBSD Apache que mostra el text:

It works!

Comproveu el vostre fitxer de configuració predeterminat d'Apache per assegurar-vos que la DocumentRootdirectiva apunta al directori correcte:

sudo vi /usr/local/etc/apache24/httpd.conf

L' DocumentRootopció de configuració serà així:

DocumentRoot "/usr/local/www/apache24/data"

Ara hem d'habilitar el mod_rewritemòdul Apache. Podem fer-ho cercant al fitxer de configuració d'Apache per defecte el terme mod_rewrite.

De manera predeterminada, el mod_rewritemòdul Apache es comentarà (el que significa que està desactivat). La línia de configuració d'una instància neta de Vultr FreeBSD 11 tindrà aquest aspecte:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Simplement traieu el símbol hash per eliminar el comentari de la línia i carregar el mòdul. Això, per descomptat, també s'aplica a qualsevol altre mòdul d'Apache necessari:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Ara hem d'editar la Directorydirectiva Apache al mateix fitxer de configuració perquè mod_rewritefuncioni correctament amb ProcessWire CMS.

Cerqueu la secció del fitxer de configuració que comença amb <Directory "/usr/local/www/apache24/data">i canvieu-la AllowOverride nonea AllowOverride All. El resultat final (amb tots els comentaris eliminats) semblarà a això:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Ara deseu i sortiu del fitxer de configuració d'Apache.

Reiniciarem Apache al final d'aquest tutorial, però reiniciar Apache regularment durant la instal·lació i la configuració és sens dubte un bon hàbit, així que fem-ho ara:

sudo service apache24 restart

Pas 4: instal·leu PHP 7.1

Ara podem instal·lar PHP 7.1 juntament amb tots els mòduls PHP necessaris que requereix ProcessWire CMS:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip

FreeBSD 11 ens dóna l'opció d'utilitzar un desenvolupament php.inio una producció php.ini. Com que instal·lem Siverstripe en un servidor web públic, utilitzarem la versió de producció. Primer, fes una còpia de seguretat php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

A continuació, feu un enllaç suau php.ini-productiona php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

We need to configure Apache to actually use PHP, so let's create a new file called php.conf in the Apache Includes directory:

sudo vi /usr/local/etc/apache24/Includes/php.conf

Enter the following text into the newly created file:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

Save and exit the file.

Now let's restart Apache so that it can reload the configuration changes:

sudo service apache24 restart

Step 5: Install MariaDB (MySQL) Server

FreeBSD 11 defaults to using MariaDB database server, which is an enhanced, fully open source, community developed, drop-in replacement for MySQL server.

Install MariaDB database server:

sudo pkg install mariadb102-server mariadb102-client

Start and enable MariaDB server to execute automatically at boot time:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Secure your MariaDB server installation:

sudo mysql_secure_installation

Quan se us demani que creeu un rootusuari MariaDB/MySQL , seleccioneu "Y" (per a sí) i després introduïu una rootcontrasenya segura . Simplement responeu "Y" a totes les altres preguntes sí/no, ja que els suggeriments predeterminats són les opcions més segures.

Pas 6: creeu una base de dades per a ProcessWire CMS

Inicieu sessió al shell de MariaDB com a rootusuari de MariaDB executant l'ordre següent:

sudo mysql -u root -p

Per accedir a l'indicador d'ordres de MariaDB, només cal que introduïu la rootcontrasenya de MariaDB quan se us demani.

Executeu les consultes següents per crear una base de dades MariaDB i un usuari de base de dades per a ProcessWire CMS:

CREATE DATABASE pw_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'pw_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON pw_db.* TO 'pw_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Podeu substituir el nom de la base de dades pw_dbi el nom pw_userd' usuari per alguna cosa més al vostre gust, si ho preferiu. A més, assegureu-vos que substituïu "UltraSecurePassword" per una contrasenya realment segura.

Pas 7: instal·leu els fitxers CMS de ProcessWire

Canvieu el vostre directori de treball actual al directori web predeterminat:

cd /usr/local/www/apache24/data

El vostre directori de treball actual hauria de ser ara: /usr/local/www/apache24/data. Podeu comprovar-ho amb l' pwdordre (imprimir el directori de treball):

pwd

Ara feu servir wgetper descarregar el paquet d'instal·lació de ProcessWire CMS:

sudo wget https://github.com/processwire/processwire/archive/master.zip

Tingueu en compte: definitivament hauríeu de comprovar la versió més recent visitant la pàgina de descàrrega de ProcessWire CMS .

Enumereu el directori actual per comprovar que heu descarregat correctament el fitxer:

ls -la

Eliminar index.html:

sudo rm index.html

Ara descomprimiu l'arxiu zip:

sudo unzip master.zip

Mou tots els fitxers d'instal·lació al directori arrel web:

sudo mv processwire-master/* /usr/local/www/apache24/data

Canvieu la propietat dels fitxers web per evitar problemes de permisos:

sudo chown -R www:www * ./

Reinicieu Apache de nou:

sudo service apache24 restart

Pas 8: completeu la instal·lació de ProcessWire CMS

Ara és el moment de visitar l'adreça IP de la instància del vostre servidor al vostre navegador, o si ja heu configurat la vostra configuració de Vultr DNS (i li heu donat temps suficient per propagar-se), simplement podeu visitar el vostre domini.

Per accedir a la pàgina d'instal·lació de ProcessWire CMS, introduïu l'adreça IP de la vostra instància Vultr a la barra d'adreces del vostre navegador, seguida de index.php:

http://YOUR_VULTR_IP_ADDRESS/install.php

L'instal·lador de ProcessWire CMS conté moltes opcions, així que aquí teniu alguns consells per ajudar-vos:

1. A la pàgina de benvinguda de la instal·lació de ProcessWire CMS, feu clic al Get Startedbotó per iniciar el procés d'instal·lació.

2. Ara seleccioneu el vostre perfil d'instal·lació preferit (o lloc de demostració) i feu clic a Continue.

3. Veureu una Compatibility Checkpàgina. Si veieu algun error, probablement vol dir que us perdeu alguns mòduls PHP o teniu un problema de permisos, en cas contrari només podeu fer clic a Continue.

4. Introduïu els valors següents a la MySQL Database Settingspàgina:

   DB Name:            pw_db
   DB User:            pw_user
   DB Pass:            UltraSecurePassword
   DB Host:            localhost
   DB Port:            3306
   

5. Podeu deixar la File Permissionconfiguració amb els seus valors predeterminats, o bé podeu ajustar-los si enteneu les implicacions.

6. Podeu introduir els futurs noms d'amfitrió del vostre lloc a la secció corresponent, o podeu editar el site/config.phpfitxer més tard si ho preferiu.

7. Feu clic a Continueper configurar la base de dades i instal·lar els fitxers ProcessWire CMS.

8. A continuació, seleccioneu el vostre preferit Admin Theme.

9. Podeu canviar-lo Admin URLsi ho preferiu, o simplement podeu deixar-lo al valor predeterminat.

10. Introduïu el vostre Admin Login Detailstal com es mostra a continuació:

    User (a-z 0-9):     <admin username>
    Password:           <admin password>
    Password (again):   <same admin password>
    Email Address:      <admin email address>
    

11. Un cop introduïts tots els detalls adequats, podeu fer clic Continueper finalitzar la instal·lació de ProcessWire.

12. Un cop finalitzada la instal·lació, només cal que feu clic al Login to Adminbotó per iniciar sessió a la secció Administrador.

És possible que vegis un avís que digui alguna cosa com:

Warning: your server locale is undefined and may cause issues. Please add this to /site/config.php file (adjust en_US.UTF-8†as needed): setlocale(LC_ALL,'en_US.UTF-8');

Podeu corregir aquest error editant el site/config.phpfitxer:

sudo vi site/config.php

Afegiu el valor adequat al final del fitxer:

setlocale(LC_ALL,'en_GB.utf8');

Si no podeu esbrinar quin valor utilitzar, podeu trobar una llista de valors adequats per a la vostra instància de servidor particular executant l' localeordre:

locale -a

No oblideu desar i sortir del site/config.phpfitxer quan hàgiu acabat d'editar.

Per motius de seguretat, assegureu-vos de canviar els permisos del site/config.phpfitxer:

sudo chmod 400 site/config.php

Reinicieu Apache.

sudo service apache24 restart

Ja esteu preparat per començar a afegir el vostre contingut i a configurar l'aspecte del vostre lloc. Assegureu-vos de consultar l'excel·lent documentació de ProcessWire CMS per obtenir més informació sobre com crear i configurar el vostre lloc.