Jak nainstalovat BoltWire CMS s Nginx na Ubuntu 20.04 LTS

Bolt je odlehčený systém pro správu obsahu (CMS) postavený na populárním frameworku PHP. Bolt je ideální pro malé firmy, které si chtějí udržovat vlastní webovou stránku bez obav, že se budou muset učit HTML a další programovací jazyky. Bolt obsahuje pokročilé funkce, jako jsou robustní značky wiki, e-commerce, fotogalerie a vytváření alb, audio galerie a přehrávač a knihy návštěv.

Boltwire vyniká tím, že je zcela zdarma pro jednotlivce a skupiny všech velikostí, kteří potřebují CMS. Joe Casabona je tvůrcem Boltwire a sdílí svou vášeň tím, že pomáhá ostatním vytěžit maximum z jeho open-source projektu. Bolt se používá ve více než 200 zemích ke správě více než 500 000 webových stránek. Jeho vývojáři jsou dobrovolníci a očekávají, že se všichni uživatelé zúčastní projektu tím, že budou nabízet zpětnou vazbu a přispívat k jeho vývoji.

Bolt má některé jedinečné vlastnosti:

• Dynamické generování stránky:Stránku lze sestavit na základě dat nalezených při jejím načítání z databáze. Když například uživatel vloží nový příspěvek do online deníku, lze dynamicky přidávat další záznamy jeho blogu, aniž by bylo nutné obnovovat celou webovou stránku. To umožňuje rychlejší načítání, zejména u velkého množství stránek nebo mediálních položek na kategorii (např. všechny fotografie ve fotogalerii).
• Správa a správa obsahu:Obsah může spravovat více uživatelů, aby bylo zajištěno, že každý uživatel může měnit pouze určité části stránek. Mohou být také omezeni na to, co mohou vidět nebo upravovat. Většině lidí například není dovoleno volně posílat nové články nebo přidávat komentáře; toto je vyhrazeno pro správce webu. Čtenáři mohou stále prohlížet jakýkoli článek bez předchozího přihlášení, pokud správce nestanoví jinak.
• Snadné použití:Bolt výrazně snižuje množství úsilí potřebného k vytvoření webových stránek ve srovnání s jinými CMS, jako jsou Joomla a Drupal. Průvodci zabudovaní do Boltu automatizují většinu jeho konfiguračního procesu, takže se nemusíte starat o to, jak věci fungují pod kapotou.
• Snadná rozšiřitelnost:Protože je Bolt open source, je snadné vytvářet nové moduly, které rozšíří nebo přidají funkce Boltu. Nové funkce jsou často integrovány do základního softwaru, takže jejich používání je ještě jednodušší. Díky asi 40 rozšířením dostupným v současnosti na Modboomu můžete snadno rozšířit kteroukoli část Boltu, aniž byste se museli příliš pouštět do programování PHP.
• BoltWire je k dispozici v řadě jazyků:angličtina (výchozí), němčina, italština, japonština, polština, portugalština a španělština. Kromě standardních balíčků BoltWire pro výše uvedené jazyky je k dispozici plná lokalizace také ve francouzštině (100 %) a holandštině (více než 50 %).

Nevýhodou je, že kromě fór nápovědy je k dispozici jen malá podpora, pokud máte nějaké dotazy ohledně toho, jak věci fungují pod kapotou ve vašem místním jazyce. V tomto ohledu je vaší vlastní odpovědností, aby věci fungovaly tak, jak byste chtěli. Pokud se však vyznáte v textovém editoru a máte čas pracovat na Boltu sami, pak vám nic nebrání vytvořit jednoduchý, ale profesionálně vypadající web během několika minut.

V této příručce se naučíme, jak nainstalovat BoltWire na server Ubuntu 20.04.

Předpoklady

• Nový server se systémem Ubuntu 20.04.
• Plný SSH root přístup nebo uživatel s právy sudo.
• Název domény je zaregistrován a odkazuje na váš server.

Začínáme

Nejprve se přihlaste do svého Ubuntu pomocí SSH.

ssh [e-mail chráněný]_Adresa -p Číslo_portu

root je výchozí uživatel na Ubuntu, nahraďte „root“ jménem svého vlastního uživatele, pokud používáte jiného.

IP_Address je adresa vašeho serveru. Můžete to zkontrolovat pomocí

hostname -I  na příkazovém řádku. Port_number musí být 22 pro SSH.

hostname -I

'-p' říká ssh, aby použil zadaný port. Pokud nezadáte číslo portu, použije se 22.

Pokud jste za firewallem, port 22 může být blokován. V takovém případě změňte číslo portu na něco jiného, ​​například 2222.

Aktualizace systému

Můžete zkontrolovat, zda má váš systém nainstalovanou správnou verzi Ubuntu, pomocí následujícího příkazu:

sudo lsb_release -a

Ukázkový výstup: 

Před instalací balíčků je vždy vhodné aktualizovat systém.

sudo apt-get update && apt-get upgrade -y

-y je příkaz, který automaticky odpoví 'Ano' na všechny otázky během procesu aktualizace. apt-get update aktualizuje seznamy balíčků a apt-get upgrade aktualizuje váš systém.

Ukázkový výstup: 

Aktualizace může nějakou dobu trvat v závislosti na počtu balíčků, které je třeba stáhnout a nainstalovat. Po dokončení aktualizace budete vyzváni k restartování serveru. Spuštěním níže uvedeného příkazu restartujte systém po aktualizacích:

sudo reboot

Instalace požadovaných balíčků

Instalace Boltu vyžaduje instalaci několika balíčků do vašeho systému. Některé z balíčků jsou instalovány v určitém pořadí. V tomto případě nainstalujeme veškerý balíček potřebný pro instalaci Bolt pomocí příkazu níže:

sudo apt install -y curl wget vim git unzip socat bash-completion apt-transport-https

socat je pro proxying, díky čemuž se zdá, že Bolt běží na webovém serveru.

apt-transport-https umožňuje operacím příkazového řádku, jako je sudo apt update, pracovat s připojeními https. bash-completion je program, který bash umožňuje automatické dokončování příkazů po zadání prvních několika znaků.

curl se používá ke stahování balíčků a wget se používá ke stahování souborů, jako je nejnovější verze Boltu, z jeho webových stránek.

Ukázkový výstup: 

Instalace Nginx

Nginx se používá jako reverzní proxy pro správu vašich webových stránek v Boltu. Nginx je lehký, snadno konfigurovatelný a rychlý. Spuštěním níže uvedeného příkazu nainstalujte Nginx

sudo apt-get install nginx

Pokud budete vyzváni, zadejte „y“, instalační proces se spustí automaticky.

Ukázkový výstup: 

Po dokončení instalace spusťte službu nginx a povolte její spuštění při startu systému

sudo systemctl start nginx

sudo systemctl enable nginx

Chcete-li zkontrolovat a ověřit, zda Nginx aktuálně běží nebo ne, použijte tento příkaz v terminálu.

sudo systemctl status nginx

Ukázkový výstup: 

Konfigurace Nginx 

BoltWire CMS je nainstalován do adresáře /var/www/. Pro přístup a testování BoltWire CMS musíme nakonfigurovat blok serveru Nginx tak, aby automaticky směroval požadavky na cestu složky webroot /var/www/ pro všechny požadavky na statický obsah, stejně jako požadavky na soubory modulů a pluginů.

Spuštěním následujících příkazů vytvořte nový konfigurační soubor s názvem bolt.conf

sudo nano /etc/nginx/sites-available/bolt.conf

Naplňte konfigurační soubor následujícím obsahem:

server {
  listen 80; 
  listen [::]:80; 
  root /var/www/bolt; 
  index index.php index.html index.htm; 
  server_name bolt.example.com;

  location / { 
    try_files      $uri $uri/ /index.php?$query_string; 
  } 

  location ~ [^/]\.php(/|$) { 
    try_files      /index.php =404; 
    fastcgi_split_path_info ^(.+\.php)(/.+)$; 
    fastcgi_index      index.php; 
    fastcgi_pass       unix:/var/run/php/php7.2-fpm.sock; 
    include         fastcgi_params; 
    fastcgi_param  PATH_INFO    $fastcgi_path_info; 
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 
  } 

 location = /bolt { 
  try_files        $uri /index.php?$query_string; 
 } 

 location ^~ /bolt/ { 
  try_files         $uri /index.php?$query_string; 
 } 

}

Blok serveru Nginx, který jsme právě vytvořili, používá výchozí kořen dokumentu, který je nastaven na adresář /var/www/. Pokud používáte BoltWire CMS v jiném serverovém prostředí, upravte soubor conf a podle toho nahraďte cestu kořenového adresáře dokumentu.

Direktiva server_name konfiguruje adresu URL, které bude váš webový server Nginx naslouchat. Nahraďte bolt.example.com skutečným názvem domény serveru nebo IP adresou.

try_files      $uri $uri/ /index.php?$query_string; Tato direktiva vám umožňuje přímo zpracovávat požadavky na cestu k souboru, pokud jsou nalezeny. Například, pokud se uživatel pokusí o přístup na domovskou stránku BoltWire CMS z prohlížeče, /index.php bude použit jako indexový soubor, pokud existuje, vrátí se zpět na odpověď PHP-FPM s návratem 404 Nenalezeno.

Po provedení změn a jejich uložení do souboru bolt.conf znovu načtěte Nginx a restartujte jej, aby se nová konfigurace projevila.

sudo systemctl reload nginx

sudo systemctl restart nginx

Zkontrolujte konfiguraci nginx spuštěním následujících příkazů:

sudo nginx -t

Ukázkový výstup: 

Instalace MySQL

BoltWire CMS vyžaduje minimálně verzi 4.2 serveru MySQL, ale BoltWire CMS nefunguje s 5.x+.

Máte tedy několik možností:Použijte vzdálený databázový server, jako je Microsoft SQL Server Implementujte MySQL na všech počítačích s webovým serverem (nedoporučuje se) Upgradujte svou verzi MySQL. První možnosti jsou poměrně jednoduché, ale typ upgradu je složitý.

Pro ty, kteří používají LAMP stack (Linux, Apache, MySQL a PHP), nemusí MySQL instalovat samostatně, protože Ubuntu již obsahuje MySQL server ve svém úložišti.

Spuštěním níže uvedeného příkazu nainstalujte MySQL:

sudo apt -y install mysql-server

Ukázkový výstup: 

Po dokončení instalace spusťte níže uvedený příkaz pro spuštění démona MySQL (server MySQL) pro tuto relaci a povolení jeho spuštění při startu systému:

sudo systemctl start mysql

sudo systemctl enable mysql 

Vytvoření databáze

Použijeme příkazový řádek k vytvoření databáze s názvem bolt.

Připojte se k mysql a vytvořte databázi spuštěním příkazu níže:

sudo mysql -u root -p 

Zadejte heslo root pro mysql. Nyní jste přihlášeni do konzole mysql. Chcete-li vytvořit databázi a uživatele databáze, spusťte níže uvedený příkaz:

CREATE DATABASE bolt;

CREATE USER 'bolt'@'localhost' IDENTIFIED BY 'mypassword';

GRANT ALL ON bolt.* TO 'bolt'@'localhost'; 

FLUSH PRIVILEGES; 

exit

VYTVOŘIT UŽIVATELE 'bolt'@'localhost' IDENTIFIKOVANÉ OD 'mypassword' vytvoří uživatele 'bolt', jehož heslo je 'mypassword'. Zde použijte místo slova 'mojeheslo' bezpečné heslo! Vyprázdnění oprávnění znovu načte tabulku oprávnění udělení vytvořenou výše.

Instalace PHP

BoltWire CMS vyžaduje PHP verze 7 nebo vyšší a jeho vývojové hlavičky. Přidáme ppa:ondrej/php PPA s požadovanou verzí PHP (7.2), kterou můžete změnit na požadovanou verzi PHP sami. Spustíme následující příkazy pro přidání ppa a aktualizaci apt-get

sudo apt -y install software-properties-common 

sudo add-apt-repository ppa:ondrej/php 

sudo apt-get update

Spuštěním níže uvedeného příkazu nainstalujte PHP 7.2:

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-zip php7.2-pgsql php7.2-sqlite3 php7.2-curl php7.2-gd php7.2-mysql php7.2-intl php7.2-json php7.2-opcache php7.2-xml

php7.2-cli je rozhraní příkazového řádku pro PHP7.2 a s php7.2-common nainstaluje rozšíření php7.2, modul webového serveru (PHP) a standardní rozšíření CLI. S php7.2 -fpm nainstaluje FastCGI Process Manager, běžný způsob spouštění aplikací PHP z vašeho webového serveru. php7.2-mbstring nainstaluje funkce vícebajtových řetězců, které jsou vyžadovány pro BoltWire CMS. php7.2-opcache nainstaluje mezipaměť operačních kódů pro PHP7.2, která poskytuje lepší výkon a snižuje zatížení vašeho webového serveru ukládáním kompilovaných skriptů do mezipaměti. php7.2-xml nainstaluje rozšíření pro zpracování XML pro PHP7.2, která jsou nutná pro použití BoltWire CMS.

Ukázkový výstup: 

Po instalaci PHP 7.2 spusťte níže uvedené příkazy a zkontrolujte verzi PHP7.2:

php -v 

Ukázkový výstup: 

Dále otevřete výchozí konfigurační soubor PHP pro Nginx pomocí textového editoru nano:

sudo nano /etc/php/7.2/fpm/php.ini

Nyní provedeme změny na následujících řádcích:

file_uploads = On

allow_url_fopen = On

memory_limit = 256M

upload_max_filesize = 100M

max_execution_time = 360

date.timezone = America/St. Louis

• file_uploads =Zapnuto povolí funkci nahrávání souborů do BoltWire CMS.
• allow_url_fopen =Zapnuto povolí přímé adresy URL nebo přesměrování HTTP na požadavky s nahranými soubory ze vzdáleného webového serveru.
• memory_limit =256M je limit paměti PHP 7.2 v MB pro nastavení pracovních procesů Nginx. Spuštění skriptu PHP s vysokou spotřebou paměti může způsobit chybu běhu PHP.
• upload_max_filesize =100M je maximální velikost pro jeden nahraný soubor na web BoltWire CMS. Pokud chcete povolit nahrávání souboru s neomezenou velikostí, změňte tuto hodnotu na 0.
• max_execution_time =360 je maximální doba provádění v sekundách pro spuštění PHP skriptu, pokud skript překročí tuto hodnotu, bude ukončen.
• date.timezone =Amerika/St. Louis, časové pásmo vaší polohy, aby se v systému BoltWire CMS správně zobrazovaly hodnoty data a času zákazníka.

Restartujte php7.2-fpm, aby se výše uvedené změny projevily:

sudo service php7.2-fpm restart

To by mělo stačit pro požadované PHP7.2 a související balíčky, pojďme k dalšímu kroku.

Instalace aplikace Composer

BoltWire CMS vyžaduje, aby Composer přidal požadované externí knihovny na webovou stránku, takže před pokračováním v tomto tutoriálu jej musíme nejprve nainstalovat. Composer je správce balíčků pro PHP, který spravuje závislosti projektů PHP. Je to podobné jako npm nebo rubínové drahokamy NodeJS.

Nejprve se přesuneme do domovského adresáře a stáhneme instalační program: 

sudo curl -sS https://getcomposer.org/installer -o composer-setup.php

Následující příkaz nainstaluje Composer:

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Výše uvedené stáhne a nainstaluje Composer jako celosystémový binární soubor do adresáře /usr/local/bin.

Můžete se rozhodnout nakonfigurovat Composer pouze pro svého uživatele nahrazením části /usr/local/bin příkazu ~/user_

Po dokončení instalace můžete spustit níže uvedený příkaz a otestovat, zda je instalace úspěšná.

composer

Ukázkový výstup: 

Instalace Bolt

Nyní jsou všechny požadované balíčky nainstalovány a můžeme se pustit do instalace Boltu.

Nejprve se přesuneme do adresáře /var/www/ a stáhneme si nejnovější verzi Bolt CMS z GitHubu pomocí příkazu níže:

cd /var/www/

sudo git clone https://github.com/bolt/bolt.git

Ukázkový výstup: 

Po stažení by se měl zobrazit adresář s názvem bolt s jediným souborem s názvem „composer.json“, což je konfigurační soubor skladatele pro Bolt CMS.

Nyní se přesuneme do adresáře bolt a odtud nainstalujeme Bolt:

cd bolt

sudo composer install

Tento příkaz nainstaluje všechny požadované zdrojové soubory Bolt a závislosti do /var/www/bolt pomocí správce balíčků Composer.

Ukázkový výstup: 

Dalším krokem je spuštění následujícího příkazu pro nastavení pracovního adresáře Bolt:

sudo chown -R www-data:www-data /var/www/bolt

sudo chmod -R 755 /var/www/bolt

Výše uvedený příkaz změní vlastnictví souborů Bolt na uživatele www-data Nginx, takže může soubor číst a zapisovat při přístupu k adrese URL Bolt.

Dalším krokem je konfigurace konfiguračního souboru šroubu:

sudo cp app/config/config.yml.dist app/config/config.yml

Přístup k BoltWire CMS

Nyní bychom měli být schopni přistupovat k BoltWire CMS pomocí následující adresy URL z prohlížeče na počítači se systémem Linux nebo Windows:

http://localhost:8000/bolt nebo http://bolt.example.com/bolt

Měli byste získat výchozí vstupní stránku BoltWire CMS, jako je ta níže:

Vyplňte všechny požadované informace v tomto formuláři a získáte přístup ke svému ovládacímu panelu BoltWire, jako je ten níže:

Nyní jsme úspěšně nakonfigurovali linuxový server pro Bolt Wire CMS.

Pokud se potýkáte s problémem při pokusu o přístup k nově nainstalovanému BoltWire CMS. Zde je seznam běžných chyb a jejich možná řešení:

• "Přístup odepřen – chyba ". To znamená, že BoltWire CMS je spuštěn, ale nemáte přístup na jeho stránky z prohlížeče, zkuste zkontrolovat konfigurační adresář Nginx.
• "Nelze načíst dynamickou knihovnu '/var/www/BoltWire/vendor/php72-zip/libphp7. 2.so “ nebo „Chyba při provádění skriptu“. To znamená, že adresář BoltWire CMS nemá požadovaná oprávnění ke spuštění a spuštění souboru PHP.
• "Chyba při inicializaci... Žádný takový soubor nebo adresář ". To znamená, že BoltWire CMS není správně nainstalován. Je třeba zkontrolovat, zda jste dodrželi správný postup pro instalaci BoltWire CMS.
• "Oprávnění odepřeno ". To znamená, že nemáte správný přístup do adresáře /var/www/bolt nebo /var/www.
• "Závažná chyba:Třída 'PDO' nebyla nalezena v... ". To znamená, že PHP se nemůže připojit k databázi a možná budete muset zkontrolovat konfiguraci PHP.
• "Hledám ... " nebo "Upozornění:Neplatný argument zadaný pro foreach()...". To znamená, že BoltWire CMS nemůže najít, co jste mu zadali. Obvykle je to způsobeno neznalostí názvu blogu a slugu nebo cesty ve vaší konfiguraci .
• "Nelze vytvořit adresář... Nedefinovaný index:zobrazená data ". To znamená, že BoltWire CMS nemůže vytvořit svůj adresář na vašem serveru Nginx a možná budete muset zkontrolovat konfiguraci PHP.
• "Chyba analýzy:chyba syntaxe, neočekávané '=' v ... v ... ". To znamená, že BoltWire CMS nemůže spustit svůj soubor nebo nemůže přečíst jeden z vašich souborů. To se může stát, když jste ve své konfiguraci použili nesprávnou syntaxi.
• "404 nenalezeno nginx/1.14.0 (ubuntu) "Přidání záznamu 'A' pro bolt.example.com na váš server by mělo pomoci.
• "404 Nenalezeno" nebo "Požadovaná adresa URL... nebyla na tomto serveru nalezena ". To znamená, že BoltWire CMS nemohl najít své soubory. Možná budete muset zkontrolovat konfiguraci BoltWire a ujistit se, že jste v ní zadali správnou cestu.

BoltWire je nainstalován, ale neexistují žádné stránky nebo se zobrazuje přihlašovací stránka BoltWire, pokud je nainstalován CMS BoltWire, pak Bolt vyhledá výchozí šablonu BoltWire ve složce /var/www/bolt/_templates v instalačním adresáři Bolt a pokud ne Pokud tam najdete jakýkoli soubor, Bolt použije jako domovskou stránku soubor index.php v instalačním adresáři Boltu. Pokud ani to nefunguje, pak může být s vaší konfigurací PHP nebo konfigurací Nginx něco jiného.

Závěr

BoltWire CMS je skvělý software pro provozování blogu nebo osobních webových stránek. Více o Bolt CMS se můžete dozvědět na oficiálních stránkách BoltWire CMS.

Doufejme, že vám tento článek pomůže zjistit, jak nainstalovat BoltWire na server Ubuntu 20.04. Pokud se vám tento článek líbí, sdílejte jej se svými přáteli na twitteru nebo facebooku. Pokud máte nějaké dotazy, zanechte prosím níže komentář.