Jak zainstalować Monikę na FreeBSD 12

• Wymagania
• Zanim zaczniesz
• Zainstaluj PHP
• Zainstaluj MariaDB i skonfiguruj bazę danych
• Zainstaluj i skonfiguruj Nginx
• Zainstaluj Composer
• Zainstaluj i skonfiguruj Monikę

Monica to system zarządzania relacjami osobistymi typu open source. Pomyśl o tym jak o CRM (popularne narzędzie używane przez zespoły sprzedażowe w świecie korporacyjnym) dla twoich przyjaciół lub rodziny. Jego kod źródłowy jest publicznie hostowany na GitHub . W tym przewodniku omówimy proces instalacji aplikacji Monica.

Wymagania

• System FreeBSD 12
• Git
• PHP w wersji 7.2 lub nowszej z następującymi rozszerzeniami PHP:
  • json
  • iconv
  • intl
  • opcache
  • mbstring
  • xml
  • mysqli
  • pdo_mysql
  • bcmath
  • kędzior
  • gmp
  • zamek błyskawiczny
  • gd
• MariaDB
• Nginx
• Kompozytor

Zanim zaczniesz

Sprawdź wersję FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Upewnij się, że twój system FreeBSD jest aktualny.

freebsd-update fetch install
pkg update && pkg upgrade -y

Zainstaluj niezbędne pakiety.

pkg install -y sudo vim unzip curl wget bash socat git libpng-dev

Utwórz nowe konto użytkownika z preferowaną nazwą użytkownika. Użyjemy johndoe.

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Uruchom visudopolecenie i usuń komentarz z %wheel ALL=(ALL) ALLwiersza, aby umożliwić członkom wheelgrupy wykonanie dowolnego polecenia.

visudo

# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL

Teraz przejdź do nowo utworzonego użytkownika za pomocą su.

su - johndoe

UWAGA: Zamień na johndoeswoją nazwę użytkownika.

Ustaw strefę czasową.

sudo tzsetup

Zainstaluj PHP

Zainstaluj PHP, a także niezbędne rozszerzenia PHP.

sudo pkg install -y php72 php72-mbstring php72-tokenizer php72-pdo php72-pdo_mysql php72-openssl php72-hash php72-json php72-phar php72-filter php72-zlib php72-dom php72-xml php72-xmlwriter php72-xmlreader php72-pecl-imagick php72-curl php72-session php72-ctype php72-iconv php72-gd php72-simplexml php72-zip php72-filter php72-tokenizer php72-calendar php72-fileinfo php72-intl php72-phar php72-soap php72-xmlrpc php72-opcache php72-mysqli php72-bcmath php72-gmp

Sprawdź wersję.

php --version

# PHP 7.2.19 (cli) (built: Jun 20 2019 01:25:01) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies

Miękki link php.ini-productiondo php.ini.

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

Włącz i uruchom PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Zainstaluj MariaDB i skonfiguruj bazę danych

Zainstaluj MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Sprawdź wersję.

mysql --version
# mysql  Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1

Uruchom i włącz MariaDB.

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

Uruchom mysql_secure_installationskrypt, aby poprawić bezpieczeństwo instalacji.

sudo mysql_secure_installation

Zaloguj się do MariaDB jako użytkownik root.

mysql -u root -p
# Enter password:

Utwórz nową bazę danych i użytkownika. Zapamiętaj poświadczenia tego nowego użytkownika.

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;

Zainstaluj i skonfiguruj Nginx

Zainstaluj Nginx.

sudo pkg install -y nginx

Sprawdź wersję.

nginx -v
# nginx version: nginx/1.14.2

Włącz i uruchom Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Uruchom sudo vim /usr/local/etc/nginx/monica.confi skonfiguruj Nginx dla Moniki.

server {

  listen 80;
  listen [::]:80;
  server_name example.com;
  root /usr/local/www/monica/public;

  index index.php;

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

  location ~ \.php$ {
    try_files $uri =404;
    include fastcgi_params;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass 127.0.0.1:9000;
  }

}

Zapisz plik i wyjdź.

Teraz musimy dołączyć monica.confdo głównego nginx.confpliku.

Uruchom sudo vim /usr/local/etc/nginx/nginx.confi dodaj następujący wiersz do http {}bloku.

include monica.conf;

Przetestuj konfigurację.

sudo nginx -t

Załaduj ponownie Nginx.

sudo service nginx reload

Zainstaluj Composer

Zainstaluj Composer globalnie.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Sprawdź wersję.

composer --version
# Composer version 1.8.6 2019-06-11 15:03:05

Zainstaluj i skonfiguruj Monikę

Utwórz pusty folder główny dokumentu, w którym powinna być zainstalowana Monica.

sudo mkdir -p /usr/local/www/monica

Przejdź do folderu głównego dokumentu.

cd /usr/local/www/monica

Zmień własność /usr/local/www/monicafolderu na użytkownika johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/monica

Sklonuj do niego repozytorium Monica.

git clone https://github.com/monicahq/monica.git .
git checkout tags/v2.14.0

UWAGA: Znajdź najnowszą oficjalną wersję na stronie wydań w GitHub i zaktualizuj powyższy numer wersji do najnowszej wersji.

Uruchom następujące polecenie, aby utworzyć własną wersję zmiennych środowiskowych wymaganych dla projektu.

cp .env.example .env

Zaktualizuj .envplik do swoich potrzeb. Nie zapomnij ustawić DB_USERNAMEi DB_PASSWORDprzy użyciu wcześniej używanych ustawień.

Zainstaluj wszystkie pakiety.

composer install --no-interaction --no-suggest --no-dev

Wygeneruj klucz aplikacji. Spowoduje to automatyczne ustawienie APP_KEYprawidłowej wartości.

php artisan key:generate

Uruchom migracje i zainicjuj foldery bazy danych i dowiązań symbolicznych.

php artisan setup:production -v

Zmień własność /usr/local/www/monicakatalogu na www.

 sudo chown -R www:www /usr/local/www/monica

Instalacja jest zakończona. Otwórz domenę w przeglądarce i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.