Hur man installerar ProcessWire CMS 3.0 på en FreeBSD 11 FAMP VPS

ProcessWire CMS 3.0 är ett enkelt, flexibelt och kraftfullt, gratis innehållshanteringssystem (CMS) med öppen källkod. ProcessWire CMS 3.0 har ett lättanvänt API i jQuery-stil, helt modulär plugin-arkitektur och ett flexibelt och kraftfullt mallsystem som ger en lika tillfredsställande användarupplevelse för designers, utvecklare och slutanvändare.

I den här handledningen kommer vi att installera ProcessWire CMS 3.0 på en FreeBSD 11 FAMP VPS med Apache-webbserver, PHP 7.1 och en MariaDB-databas.

Förutsättningar

• En ren Vultr FreeBSD 11-serverinstans med SSH-åtkomst

Steg 1: Lägg till en Sudo-användare

Vi börjar med att lägga till en ny sudoanvändare.

Logga först in på din server som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Det sudokommando inte installeras som standard i Vultr FreeBSD 11 Server-instans, så vi kommer först installera sudo:

pkg install sudo

Lägg till en ny användare som heter user1(eller ditt föredragna användarnamn):

adduser user1

Det adduserkommando kommer att be dig för massor av information för användarkontot, så enkelt välja standard för de flesta av dem när det är vettigt att göra det. När du tillfrågas om Invite user1 into any other groups?du vill ska du ange för wheelatt lägga user1till i wheelgruppen.

Kontrollera nu /etc/sudoersfilen för att se till att sudoersgruppen är aktiverad:

visudo

Leta efter ett avsnitt så här:

# %wheel        ALL=(ALL)       ALL

Den här raden talar om för oss att användare som är medlemmar i wheelgruppen kan använda sudokommandot för att få rootprivilegier. Den kommer att kommenteras bort som standard så du måste avkommentera den och sedan spara och avsluta filen.

Vi kan verifiera user1gruppmedlemskapet med groupskommandot:

groups user1

Om du user1inte är medlem i wheelgruppen kan du använda det här kommandot för att uppdatera user1gruppmedlemskapet:

pw group mod wheel -m user1 

Använd nu sukommandot för att byta till det nya sudo användarkontot user1:

su - user1

Kommandotolken uppdateras för att indikera att du nu är inloggad på user1kontot. Du kan verifiera detta med whoamikommandot:

whoami

Starta nu om sshdtjänsten så att du kan logga in via sshmed det nya icke-root sudo användarkontot som du just har skapat:

sudo /etc/rc.d/sshd restart

Avsluta user1kontot:

exit

Avsluta rootkontot (vilket kommer att koppla bort din sshsession):

exit

Du kan nu gå sshin i serverinstansen från din lokala värd med det nya sudo-användarkontot som inte är root user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Om du vill köra sudoutan att behöva skriva ett lösenord varje gång öppnar du /etc/sudoersfilen igen med visudo:

sudo visudo

Redigera avsnittet för wheelgruppen så att det ser ut så här:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Observera: Att inaktivera lösenordskravet för sudo-användaren är inte en rekommenderad praxis, men det ingår här eftersom det kan göra serverkonfigurationen mycket bekvämare och mindre frustrerande, särskilt under längre systemadministrationssessioner. Om du är orolig över säkerhetskonsekvenserna kan du alltid återställa konfigurationsändringen till originalet efter att du har avslutat dina administrationsuppgifter.

När du vill logga in på rootanvändarkontot från sudoanvändarkontot kan du använda något av följande kommandon:

sudo -i
sudo su -

Du kan avsluta rootkontot och återgå till ditt sudoanvändarkonto när som helst genom att helt enkelt skriva exit.

Steg 2: Uppdatera FreeBSD 11 System

Innan vi installerar några paket på FreeBSD-serverinstansen kommer vi först att uppdatera systemet.

Se till att du är inloggad på servern med en icke-root sudo-användare och kör följande kommandon:

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

Steg 3: Installera Apache Web Server

Installera webbservern Apache 2.4:

sudo pkg install apache24

Och ange ynär du uppmanas. Använd nu sysrckommandot för att aktivera Apache-tjänsten att köras automatiskt vid uppstart:

sudo sysrc apache24_enable=yes

Det sysrckommando uppdaterar /etc/rc.confkonfigurationsfilen, så om du vill verifiera konfigurationen uppdateringen manuellt kan du helt enkelt öppna /etc/rc.conffilen med din favorit terminal editor:

vi /etc/rc.conf

Starta nu Apache-tjänsten:

sudo service apache24 start

Du kan snabbt kontrollera att apache körs genom att besöka IP-adressen eller domänen för serverinstansen i din webbläsare:

http://YOUR_VULTR_IP_ADDRESS/

Du kommer att se standardsidan för FreeBSD Apache som visar texten:

It works!

Kontrollera din Apache-standardkonfigurationsfil för att säkerställa att DocumentRootdirektivet pekar till rätt katalog:

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

Det DocumentRootalternativet konfigurationen ser ut så här:

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

Vi måste nu aktivera mod_rewriteApache-modulen. Vi kan göra detta genom att söka i Apaches standardkonfigurationsfil för termen mod_rewrite.

Som standard kommer mod_rewriteApache-modulen att kommenteras bort (vilket betyder att den är inaktiverad). Konfigurationsraden på en ren Vultr FreeBSD 11-instans kommer att se ut så här:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Ta helt enkelt bort hash-symbolen för att avkommentera raden och ladda modulen. Detta gäller naturligtvis även alla andra nödvändiga Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi behöver nu redigera DirectoryApache-direktivet i samma konfigurationsfil så att det mod_rewritefungerar korrekt med ProcessWire CMS.

Hitta avsnittet i konfigurationsfilen som börjar med <Directory "/usr/local/www/apache24/data">och ändra AllowOverride nonetill AllowOverride All. Slutresultatet (med alla kommentarer borttagna) kommer att se ut ungefär så här:

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

Spara och avsluta nu Apache-konfigurationsfilen.

Vi kommer att starta om Apache i slutet av denna handledning, men att starta om Apache regelbundet under installation och konfiguration är verkligen en god vana, så låt oss göra det nu:

sudo service apache24 restart

Steg 4: Installera PHP 7.1

Vi kan nu installera PHP 7.1 tillsammans med alla nödvändiga PHP-moduler som krävs av 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 ger oss möjligheten att använda en utveckling php.inieller en produktion php.ini. Eftersom vi ska installera Siverstripe på en offentlig webbserver kommer vi att använda produktionsversionen. Säkerhetskopiera först php.ini-production:

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

Mjuklänk sedan php.ini-productiontill php.ini.

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

Vi måste konfigurera Apache för att faktiskt använda PHP, så låt oss skapa en ny fil som heter php.confi Apache- Includeskatalogen:

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

Skriv in följande text i den nyskapade filen:

<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>

Spara och avsluta filen.

Låt oss nu starta om Apache så att den kan ladda om konfigurationsändringarna:

sudo service apache24 restart

Steg 5: Installera MariaDB (MySQL) Server

FreeBSD 11 använder som standard MariaDB-databasserver, som är en förbättrad, helt öppen källkod, communityutvecklad, drop-in-ersättning för MySQL-server.

Installera MariaDB databasserver:

sudo pkg install mariadb102-server mariadb102-client

Starta och aktivera MariaDB-servern att köra automatiskt vid uppstart:

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

Säkra din MariaDB-serverinstallation:

sudo mysql_secure_installation

När du uppmanas att skapa en MariaDB/MySQL- rootanvändare, välj "Y" (för ja) och ange sedan ett säkert rootlösenord. Svara helt enkelt "Y" på alla andra ja/nej-frågor eftersom standardförslagen är de säkraste alternativen.

Steg 6: Skapa databas för ProcessWire CMS

Logga in på MariaDB-skalet som MariaDB- rootanvändare genom att köra följande kommando:

sudo mysql -u root -p

För att komma åt MariaDB-kommandotolken, ange bara MariaDB- rootlösenordet när du uppmanas.

Kör följande frågor för att skapa en MariaDB-databas och databasanvändare för 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;

Du kan byta ut databasnamnet pw_dboch användarnamnet pw_usermed något mer som du vill, om du föredrar det. Se också till att du ersätter "UltraSecurePassword" med ett faktiskt säkert lösenord.

Steg 7: Installera ProcessWire CMS-filer

Ändra din nuvarande arbetskatalog till standardwebbkatalogen:

cd /usr/local/www/apache24/data

Din nuvarande arbetskatalog bör nu vara: /usr/local/www/apache24/data. Du kan kontrollera detta med pwdkommandot (skriv ut arbetskatalog):

pwd

wgetAnvänd nu för att ladda ner ProcessWire CMS-installationspaketet:

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

Observera: Du bör definitivt söka efter den senaste versionen genom att besöka nedladdningssidan för ProcessWire CMS .

Lista den aktuella katalogen för att kontrollera att du har laddat ned filen:

ls -la

Ta bort index.html:

sudo rm index.html

Packa upp zip-arkivet:

sudo unzip master.zip

Flytta alla installationsfiler till webbrotkatalogen:

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

Ändra äganderätten till webbfilerna för att undvika eventuella behörighetsproblem:

sudo chown -R www:www * ./

Starta om Apache igen:

sudo service apache24 restart

Steg 8: Slutför ProcessWire CMS-installationen

Det är nu dags att besöka IP-adressen för din serverinstans i din webbläsare, eller om du redan har konfigurerat dina Vultr DNS-inställningar (och gett den tillräckligt med tid för att spridas) kan du helt enkelt besöka din domän istället.

För att komma åt ProcessWire CMS-installationssidan anger du din Vultr-instans-IP-adress i webbläsarens adressfält, följt av index.php:

http://YOUR_VULTR_IP_ADDRESS/install.php

ProcessWire CMS-installationsprogrammet innehåller många alternativ, så här är några tips som hjälper dig:

1. På välkomstsidan för ProcessWire CMS installation, klicka på Get Startedknappen för att starta installationsprocessen.

2. Välj nu önskad installationsprofil (eller demosida) och klicka på Continue.

3. Du kommer att se en Compatibility Checksida. Om du ser några fel betyder det förmodligen att du saknar några PHP-moduler eller har ett behörighetsproblem, annars kan du helt enkelt klicka på Continue.

4. Ange följande värden på MySQL Database Settingssidan:

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

5. Du kan lämna File Permissioninställningarna på deras standardvärden, eller så kan du justera dem om du förstår konsekvenserna.

6. Du kan ange de framtida värdnamnen för din webbplats i lämpligt avsnitt, eller så kan du redigera site/config.phpfilen senare om du föredrar det.

7. Klicka på för Continueatt konfigurera databasen och installera ProcessWire CMS-filerna.

8. Välj sedan önskad Admin Theme.

9. Du kan ändra Admin URLom du föredrar det, eller så kan du helt enkelt lämna det på standardvärdet.

10. Ange din Admin Login Detailssom visas nedan:

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

11. När alla lämpliga detaljer har angetts kan du klicka för Continueatt slutföra ProcessWire-installationen.

12. När installationen är klar klickar du bara på Login to Adminknappen för att logga in i avsnittet Admin.

Du kan se en varning som säger något i stil med:

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');

Du kan åtgärda det här felet genom att redigera site/config.phpfilen:

sudo vi site/config.php

Lägg till lämpligt värde i slutet av filen:

setlocale(LC_ALL,'en_GB.utf8');

Om du inte kan ta reda på vilket värde du ska använda kan du hitta en lista med lämpliga värden för just din serverinstans genom att köra localekommandot:

locale -a

Glöm inte att spara och avsluta site/config.phpfilen när du är klar med redigeringen.

Av säkerhetsskäl, se till att du ändrar behörigheterna för site/config.phpfilen:

sudo chmod 400 site/config.php

Starta om Apache.

sudo service apache24 restart

Du är redo att börja lägga till ditt innehåll och konfigurera utseendet och känslan på din webbplats. Se till att kolla in den utmärkta ProcessWire CMS-dokumentationen för mer information om hur du bygger och konfigurerar din webbplats.