Sådan installeres ProcessWire CMS 3.0 på en FreeBSD 11 FAMP VPS

ProcessWire CMS 3.0 er et enkelt, fleksibelt og kraftfuldt, gratis og open source Content Management System (CMS). ProcessWire CMS 3.0 har en brugervenlig jQuery-stil API, fuldt modulær plugin-arkitektur og et fleksibelt og kraftfuldt skabelonsystem, der leverer en lige så tilfredsstillende brugeroplevelse for designere, udviklere og slutbrugere.

I denne tutorial skal vi installere ProcessWire CMS 3.0 på en FreeBSD 11 FAMP VPS ved hjælp af Apache-webserver, PHP 7.1 og en MariaDB-database.

Forudsætninger

• En ren Vultr FreeBSD 11-serverinstans med SSH-adgang

Trin 1: Tilføj en Sudo-bruger

Vi starter med at tilføje en ny sudobruger.

Først skal du logge ind på din server som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Den sudoKommandoen er ikke installeret som standard i Vultr FreeBSD 11 serversubsystem, så vil vi først installere sudo:

pkg install sudo

Tilføj en ny bruger kaldet user1(eller dit foretrukne brugernavn):

adduser user1

Den adduserkommando vil bede dig for masser af oplysninger om brugerens konto, så skal du blot vælge standarderne for de fleste af dem, når det giver mening at gøre det. Når du bliver spurgt, om Invite user1 into any other groups?du skal , skal du indtaste for wheelat tilføje user1til wheelgruppen.

Tjek nu /etc/sudoersfilen for at sikre, at sudoersgruppen er aktiveret:

visudo

Se efter et afsnit som dette:

# %wheel        ALL=(ALL)       ALL

Denne linje fortæller os, at brugere, der er medlemmer af wheelgruppen, kan bruge sudokommandoen til at opnå rootprivilegier. Det vil blive kommenteret ud som standard, så du bliver nødt til at fjerne kommentaren og derefter gemme og afslutte filen.

Vi kan bekræfte user1gruppemedlemskabet med groupskommandoen:

groups user1

Hvis du user1ikke er medlem af wheelgruppen, kan du bruge denne kommando til at opdatere user1gruppemedlemskabet:

pw group mod wheel -m user1 

Brug nu sukommandoen til at skifte til den nye sudo-brugerkonto user1:

su - user1

Kommandoprompten opdateres for at angive, at du nu er logget ind på user1kontoen. Du kan bekræfte dette med whoamikommandoen:

whoami

Genstart nu sshdtjenesten, så du kan logge på sshmed den nye ikke-root sudo-brugerkonto, du lige har oprettet:

sudo /etc/rc.d/sshd restart

Afslut user1kontoen:

exit

Afslut rootkontoen (hvilket vil afbryde forbindelsen til din sshsession):

exit

Du kan nu gå sshind i serverforekomsten fra din lokale vært ved at bruge den nye ikke-root sudo-brugerkonto user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Hvis du vil udføre sudouden at skulle indtaste en adgangskode hver gang, skal du åbne /etc/sudoersfilen igen ved at bruge visudo:

sudo visudo

Rediger sektionen for wheelgruppen, så den ser sådan ud:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Bemærk venligst: Deaktivering af adgangskodekravet for sudo-brugeren er ikke en anbefalet praksis, men det er inkluderet her, da det kan gøre serverkonfigurationen meget mere bekvem og mindre frustrerende, især under længere systemadministrationssessioner. Hvis du er bekymret over sikkerhedskonsekvenserne, kan du altid gendanne konfigurationsændringen til den oprindelige, når du er færdig med dine administrationsopgaver.

Når du vil logge ind på rootbrugerkontoen fra sudobrugerkontoen, kan du bruge en af ​​følgende kommandoer:

sudo -i
sudo su -

Du kan forlade rootkontoen og vende tilbage til din sudobrugerkonto når som helst ved blot at skrive exit.

Trin 2: Opdater FreeBSD 11 System

Før vi installerer nogen pakker på FreeBSD-serverinstansen, vil vi først opdatere systemet.

Sørg for, at du er logget ind på serveren med en ikke-root sudo-bruger, og kør følgende kommandoer:

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

Trin 3: Installer Apache Web Server

Installer Apache 2.4-webserveren:

sudo pkg install apache24

Og indtast, ynår du bliver bedt om det. Brug nu sysrckommandoen til at aktivere Apache-tjenesten til at køre automatisk ved opstart:

sudo sysrc apache24_enable=yes

Den sysrckommando opdaterer /etc/rc.confkonfigurationsfil, så hvis du ønsker at kontrollere konfigurationen opdateringen manuelt kan du blot åbne /etc/rc.conffilen med din favorit terminal redaktør:

vi /etc/rc.conf

Start nu Apache-tjenesten:

sudo service apache24 start

Du kan hurtigt kontrollere, at apache kører, ved at besøge IP-adressen eller domænet for serverforekomsten i din browser:

http://YOUR_VULTR_IP_ADDRESS/

Du vil se standard FreeBSD Apache-siden, der viser teksten:

It works!

Tjek din Apache-standardkonfigurationsfil for at sikre, at DocumentRootdirektivet peger på den korrekte mappe:

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

Den DocumentRootkonfiguration mulighed vil se sådan ud:

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

Vi skal nu aktivere mod_rewriteApache-modulet. Vi kan gøre dette ved at søge i standard Apache-konfigurationsfilen for udtrykket mod_rewrite.

Som standard vil mod_rewriteApache-modulet blive kommenteret ud (hvilket betyder, at det er deaktiveret). Konfigurationslinjen på en ren Vultr FreeBSD 11-instans vil se sådan ud:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Du skal blot fjerne hash-symbolet for at fjerne kommentarer til linjen og indlæse modulet. Dette gælder selvfølgelig også for alle andre påkrævede Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi skal nu redigere DirectoryApache-direktivet i den samme konfigurationsfil, så det mod_rewritefungerer korrekt med ProcessWire CMS.

Find den del af konfigurationsfilen, der starter med, <Directory "/usr/local/www/apache24/data">og skift AllowOverride nonetil AllowOverride All. Slutresultatet (med alle kommentarer fjernet) vil se nogenlunde således ud:

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

Gem og afslut nu Apache-konfigurationsfilen.

Vi genstarter Apache i slutningen af ​​denne vejledning, men at genstarte Apache regelmæssigt under installation og konfiguration er bestemt en god vane, så lad os gøre det nu:

sudo service apache24 restart

Trin 4: Installer PHP 7.1

Vi kan nu installere PHP 7.1 sammen med alle de nødvendige PHP-moduler, der kræves af 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 giver os mulighed for at bruge en udvikling php.inieller en produktion php.ini. Da vi skal installere Siverstripe på en offentlig webserver, bruger vi produktionsversionen. Sikkerhedskopier først php.ini-production:

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

Så soft-link php.ini-productiontil php.ini.

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

Vi skal konfigurere Apache til rent faktisk at bruge PHP, så lad os oprette en ny fil kaldet php.confi Apache- Includesmappen:

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

Indtast følgende tekst i den nyoprettede fil:

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

Gem og afslut filen.

Lad os nu genstarte Apache, så den kan genindlæse konfigurationsændringerne:

sudo service apache24 restart

Trin 5: Installer MariaDB (MySQL) Server

FreeBSD 11 bruger som standard MariaDB-databaseserver, som er en forbedret, fuldt open source, community-udviklet drop-in-erstatning for MySQL-server.

Installer MariaDB databaseserver:

sudo pkg install mariadb102-server mariadb102-client

Start og aktiver MariaDB-serveren til at køre automatisk ved opstart:

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

Sikre din MariaDB-serverinstallation:

sudo mysql_secure_installation

Når du bliver bedt om at oprette en MariaDB/MySQL- rootbruger, skal du vælge "Y" (for ja) og derefter indtaste en sikker rootadgangskode. Du skal blot svare "Y" på alle de andre ja/nej-spørgsmål, da standardforslagene er de mest sikre muligheder.

Trin 6: Opret database til ProcessWire CMS

Log ind på MariaDB-skallen som MariaDB- rootbrugeren ved at køre følgende kommando:

sudo mysql -u root -p

For at få adgang til MariaDB-kommandoprompten skal du blot indtaste MariaDB- rootadgangskoden, når du bliver bedt om det.

Kør følgende forespørgsler for at oprette en MariaDB-database og databasebruger til 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 erstatte databasenavnet pw_dbog brugernavnet pw_usermed noget mere efter din smag, hvis du foretrækker det. Sørg også for at erstatte "UltraSecurePassword" med en faktisk sikker adgangskode.

Trin 7: Installer ProcessWire CMS-filer

Skift din nuværende arbejdsmappe til standardwebbiblioteket:

cd /usr/local/www/apache24/data

Din nuværende arbejdsmappe skulle nu være: /usr/local/www/apache24/data. Du kan kontrollere dette med pwdkommandoen (udskriv arbejdsmappe):

pwd

Brug nu wgettil at downloade ProcessWire CMS-installationspakken:

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

Bemærk venligst: Du bør helt sikkert tjekke efter den seneste version ved at besøge ProcessWire CMS-downloadsiden .

List den aktuelle mappe for at kontrollere, at du har downloadet filen:

ls -la

Fjern index.html:

sudo rm index.html

Udkomprimer nu zip-arkivet:

sudo unzip master.zip

Flyt alle installationsfilerne til web-rodmappen:

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

Skift ejerskab af webfilerne for at undgå problemer med tilladelser:

sudo chown -R www:www * ./

Genstart Apache igen:

sudo service apache24 restart

Trin 8: Fuldfør ProcessWire CMS-installationen

Det er nu tid til at besøge IP-adressen på din serverforekomst i din browser, eller hvis du allerede har konfigureret dine Vultr DNS-indstillinger (og givet den tid nok til at sprede sig), kan du blot besøge dit domæne i stedet for.

For at få adgang til ProcessWire CMS installationssiden skal du indtaste din Vultr-instans IP-adresse i din browsers adresselinje efterfulgt af index.php:

http://YOUR_VULTR_IP_ADDRESS/install.php

ProcessWire CMS-installationsprogrammet indeholder en masse muligheder, så her er et par tips til at hjælpe dig på vej:

1. På velkomstsiden til ProcessWire CMS installation skal du klikke på Get Startedknappen for at starte installationsprocessen.

2. Vælg nu din foretrukne installationsprofil (eller demoside), og klik på Continue.

3. Du vil se en Compatibility Checkside. Hvis du ser nogen fejl, betyder det sandsynligvis, at du mangler nogle PHP-moduler eller har et tilladelsesproblem, ellers kan du blot klikke på Continue.

4. Indtast følgende værdier på MySQL Database Settingssiden:

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

5. Du kan lade File Permissionindstillingerne blive ved deres standardværdier, eller du kan justere dem, hvis du forstår implikationerne.

6. Du kan indtaste de fremtidige værtsnavne på dit websted i den relevante sektion, eller du kan redigere site/config.phpfilen senere, hvis du foretrækker det.

7. Klik på for Continueat konfigurere databasen og installere ProcessWire CMS-filerne.

8. Vælg derefter din foretrukne Admin Theme.

9. Du kan ændre det, Admin URLhvis du foretrækker det, eller du kan blot lade det være på standardværdien.

10. Indtast din Admin Login Detailssom vist nedenfor:

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

11. Når alle de relevante detaljer er indtastet, kan du klikke for Continueat afslutte ProcessWire-installationen.

12. Når installationen er fuldført, skal du blot klikke på Login to Adminknappen for at logge på Admin-sektionen.

Du kan muligvis se en advarsel, der siger noget som:

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 rette denne fejl ved at redigere site/config.phpfilen:

sudo vi site/config.php

Tilføj den relevante værdi til slutningen af ​​filen:

setlocale(LC_ALL,'en_GB.utf8');

Hvis du ikke kan finde ud af, hvilken værdi du skal bruge, kan du finde en liste over passende værdier for din bestemte serverinstans ved at køre localekommandoen:

locale -a

Glem ikke at gemme og afslutte site/config.phpfilen, når du er færdig med at redigere.

Af sikkerhedsmæssige årsager skal du sørge for at ændre tilladelserne på site/config.phpfilen:

sudo chmod 400 site/config.php

Genstart Apache.

sudo service apache24 restart

Du er klar til at begynde at tilføje dit indhold og konfigurere udseendet og følelsen af ​​dit websted. Sørg for at tjekke den fremragende ProcessWire CMS-dokumentation for mere information om, hvordan du opbygger og konfigurerer dit websted.