Hur man installerar Pagekit 1.0 CMS på en FreeBSD 11 FAMP VPS

Pagekit 1.0 CMS är ett vackert, modulärt, utbyggbart och lätt, gratis och open source Content Management System (CMS) med ett rent och intuitivt användargränssnitt som drivs av Vue.js. Pagekit 1.0 CMS har en modulär arkitektur byggd på Symfony-komponenter med en enkel ORM, en HTML- och Markdown-redigerare med förhandsgranskning i realtid, ett kraftfullt användar- och behörighetssystem och en flexibel filhanterare som tillåter webbutvecklare att redigera sidor och hantera widgets med enkel dra och släpp-funktion.

I den här handledningen kommer vi att installera Pagekit 1.0 CMS 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 nu 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 sudo utan att behöva skriva ett lösenord varje gång, öppna sedan /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 Apache-webbservern:

sudo pkg install apache24

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 bör 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 DocumentRootalternativ konfiguration bör se 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 Pagekit 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 Pagekit 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 php71-phar

FreeBSD 11 ger oss möjligheten att använda en utveckling php.inieller en produktion php.ini. Eftersom vi ska installera Pagekit 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

Länka 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 den senaste versionen av 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 Pagekit 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 Pagekit CMS:

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

Du kan byta ut databasnamnet pagekit_dboch användarnamnet pagekit_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 Pagekit CMS-filer

Ändra din nuvarande arbetskatalog till standardwebbkatalogen:

cd /usr/local/www/apache24/data

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

pwd

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

sudo wget http://pagekit.com/api/download/latest

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 latest

Ä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

Nu är vi redo att gå vidare till det sista steget.

Steg 8: Slutför installationen av Pagekit CMS

Det är 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 installationssidan för Pagekit CMS anger du IP-adressen för din Vultr-instans i webbläsarens adressfält, följt av /index.php:

http://YOUR_VULTR_IP_ADDRESS/index.php

De flesta av installationsalternativen för Pagekit CMS är självförklarande, men här är några tips som hjälper dig:

1. Klicka på pilen för att starta installationsprocessen.

2. Välj ditt språk och klicka på NEXTknappen.

3. Välj MySQLsom din Database Driveroch ange sedan följande databasdetaljer:

   Hostname:           localhost
   User:               pagekit_user
   Password:           UltraSecurePassword
   Database Name:      pagekit_db
   Table Prefix:       pk_
   

   Klicka för NEXTatt fortsätta.

4. Ange din Site Titleoch Administrator Detailsenligt följande:

   Site Title:         <your site title>
   Username:           <your admin username>
   Password:           <your admin password>
   Email:              <your admin email address>
   

5. Klicka för INSTALLatt köra installationsprogrammet för Pagekit CMS.

Du kommer att omdirigeras till sidan för administratörsinloggning. Om du inte omdirigeras till administratörens inloggningssida kan du ange administratörsadressen manuellt:

http://YOUR_VULTR_IP_ADDRESS/admin/login

Ange bara ditt administratörs användarnamn och lösenord på inloggningssidan.

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