So installieren Sie Monica unter FreeBSD 12

• Bedarf
• Bevor Sie beginnen
• Installieren Sie PHP
• Installieren Sie MariaDB und richten Sie eine Datenbank ein
• Installieren und konfigurieren Sie Nginx
• Installieren Sie Composer
• Installieren und konfigurieren Sie Monica

Monica ist ein Open-Source-System für das persönliche Beziehungsmanagement. Stellen Sie sich das als CRM (ein beliebtes Tool für Verkaufsteams in der Unternehmenswelt) für Ihre Freunde oder Familie vor. Der Quellcode wird öffentlich auf GitHub gehostet . In diesem Handbuch werden wir den Installationsprozess einer Monica-Anwendung erläutern.

Bedarf

• FreeBSD 12 System
• Git
• PHP Version 7.2 oder höher mit den folgenden PHP-Erweiterungen:
  • json
  • iconv
  • intl
  • opcache
  • mbstring
  • xml
  • Mysqli
  • pdo_mysql
  • bcmath
  • locken
  • gmp
  • Postleitzahl
  • gd
• MariaDB
• Nginx
• Komponist

Bevor Sie beginnen

Überprüfen Sie die FreeBSD-Version.

uname -ro
# FreeBSD 12.0-RELEASE

Stellen Sie sicher, dass Ihr FreeBSD-System auf dem neuesten Stand ist.

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

Installieren Sie die erforderlichen Pakete.

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

Erstellen Sie ein neues Benutzerkonto mit Ihrem bevorzugten Benutzernamen. Wir werden verwenden 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!

Führen Sie den visudoBefehl aus und kommentieren Sie die %wheel ALL=(ALL) ALLZeile aus, damit Mitglieder der wheelGruppe einen beliebigen Befehl ausführen können.

visudo

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

Wechseln Sie nun mit zu Ihrem neu erstellten Benutzer su.

su - johndoe

HINWEIS: Ersetzen Sie johndoedurch Ihren Benutzernamen.

Richten Sie die Zeitzone ein.

sudo tzsetup

Installieren Sie PHP

Installieren Sie PHP sowie die erforderlichen PHP-Erweiterungen.

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

Überprüfe die Version.

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

Softlink php.ini-productionzu php.ini.

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

Aktivieren und starten Sie PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Installieren Sie MariaDB und richten Sie eine Datenbank ein

Installieren Sie MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Überprüfe die Version.

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

Starten und aktivieren Sie MariaDB.

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

Führen Sie das mysql_secure_installationSkript aus, um die Sicherheit Ihrer Installation zu verbessern.

sudo mysql_secure_installation

Melden Sie sich bei MariaDB als Root an.

mysql -u root -p
# Enter password:

Erstellen Sie eine neue Datenbank und einen neuen Benutzer. Merken Sie sich die Anmeldeinformationen für diesen neuen Benutzer.

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

Installieren und konfigurieren Sie Nginx

Installieren Sie Nginx.

sudo pkg install -y nginx

Überprüfe die Version.

nginx -v
# nginx version: nginx/1.14.2

Aktivieren und starten Sie Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Laufen Sie sudo vim /usr/local/etc/nginx/monica.confund richten Sie Nginx für Monica ein.

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

}

Speichern Sie die Datei und beenden Sie sie.

Jetzt müssen wir monica.confin die Hauptdatei aufnehmen nginx.conf.

Führen sudo vim /usr/local/etc/nginx/nginx.confSie die folgende Zeile aus und fügen Sie sie dem http {}Block hinzu.

include monica.conf;

Testen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo service nginx reload

Installieren Sie Composer

Installieren Sie Composer global.

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

Überprüfe die Version.

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

Installieren und konfigurieren Sie Monica

Erstellen Sie einen leeren Dokumentstammordner, in dem Monica installiert werden soll.

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

Navigieren Sie zum Dokumentstammordner.

cd /usr/local/www/monica

Ändern Sie den Besitz des /usr/local/www/monicaOrdners in Benutzer johndoe.

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

Klonen Sie das Monica-Repository darauf.

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

HINWEIS: Suchen Sie die neueste offizielle Version auf der Release-Seite von GitHub und aktualisieren Sie die obige Versionsnummer auf die neueste Version.

Führen Sie die folgenden Schritte aus, um eine eigene Version der für das Projekt erforderlichen Umgebungsvariablen zu erstellen.

cp .env.example .env

Aktualisieren Sie die .envDatei auf Ihre spezifischen Anforderungen. Vergessen Sie nicht, Satz DB_USERNAMEund DB_PASSWORDmit den Einstellungen vorher verwendeten.

Installieren Sie alle Pakete.

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

Generieren Sie einen Anwendungsschlüssel. Dies wird APP_KEYautomatisch auf den richtigen Wert eingestellt.

php artisan key:generate

Führen Sie die Migrationen aus und legen Sie die Datenbank- und Symlink-Ordner fest.

php artisan setup:production -v

Ändern Sie den Besitz des /usr/local/www/monicaVerzeichnisses in www.

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

Die Installation ist abgeschlossen. Öffnen Sie Ihre Domain in Ihrem Webbrowser und befolgen Sie die Anweisungen auf dem Bildschirm.