Η Monica είναι ένα σύστημα διαχείρισης προσωπικών σχέσεων ανοιχτού κώδικα. Σκεφτείτε το ως ένα CRM (ένα δημοφιλές εργαλείο που χρησιμοποιείται από τις ομάδες πωλήσεων στον εταιρικό κόσμο) για τους φίλους ή την οικογένειά σας. Ο πηγαίος του κώδικας φιλοξενείται δημόσια στο GitHub . Σε αυτόν τον οδηγό, θα εξετάσουμε τη διαδικασία εγκατάστασης μιας εφαρμογής Monica.
Απαιτήσεις
- Σύστημα FreeBSD 12
- Git
- PHP έκδοση 7.2 ή μεταγενέστερη με τις ακόλουθες επεκτάσεις PHP:
- json
- εικονίδιο
- διεθν
- opcache
- mbstring
- xml
- mysqli
- pdo_mysql
- bcmath
- μπούκλα
- gmp
- φερμουάρ
- gd
- MariaDB
- Nginx
- Συνθέτης
Πριν ξεκινήσεις
Ελέγξτε την έκδοση του FreeBSD.
uname -ro # FreeBSD 12.0-RELEASE
Βεβαιωθείτε ότι το σύστημά σας FreeBSD είναι ενημερωμένο.
freebsd-update fetch install pkg update && pkg upgrade -y
Εγκαταστήστε τα απαραίτητα πακέτα.
pkg install -y sudo vim unzip curl wget bash socat git libpng-dev
Δημιουργήστε έναν νέο λογαριασμό χρήστη με το όνομα χρήστη που προτιμάτε. θα χρησιμοποιήσουμε 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!
Εκτελέστε την visudo
εντολή και αποσχολιάστε τη %wheel ALL=(ALL) ALL
γραμμή, για να επιτρέψετε στα μέλη της wheel
ομάδας να εκτελέσουν οποιαδήποτε εντολή.
visudo # Uncomment by removing hash (#) sign # %wheel ALL=(ALL) ALL
Τώρα, μεταβείτε στον νέο χρήστη που δημιουργήσατε με su
.
su - johndoe
ΣΗΜΕΙΩΣΗ: Αντικαταστήστε το johndoe
με το όνομα χρήστη σας.
Ρυθμίστε τη ζώνη ώρας.
sudo tzsetup
Εγκαταστήστε την PHP
Εγκαταστήστε την PHP, καθώς και τις απαραίτητες επεκτάσεις 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
Ελέγξτε την έκδοση.
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
Μαλακή σύνδεση php.ini-production
με php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Ενεργοποιήστε και ξεκινήστε το PHP-FPM.
sudo sysrc php_fpm_enable=yes sudo service php-fpm start
Εγκαταστήστε το MariaDB και ρυθμίστε μια βάση δεδομένων
Εγκαταστήστε το MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Ελέγξτε την έκδοση.
mysql --version # mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Ξεκινήστε και ενεργοποιήστε το MariaDB.
sudo sysrc mysql_enable="yes" sudo service mysql-server start
Εκτελέστε το mysql_secure_installation
σενάριο για να βελτιώσετε την ασφάλεια της εγκατάστασής σας.
sudo mysql_secure_installation
Συνδεθείτε στο MariaDB ως χρήστης root.
mysql -u root -p # Enter password:
Δημιουργία νέας βάσης δεδομένων και χρήστη. Θυμηθείτε τα διαπιστευτήρια για αυτόν τον νέο χρήστη.
CREATE DATABASE dbname; GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; exit;
Εγκαταστήστε και ρυθμίστε το Nginx
Εγκαταστήστε το Nginx.
sudo pkg install -y nginx
Ελέγξτε την έκδοση.
nginx -v # nginx version: nginx/1.14.2
Ενεργοποιήστε και ξεκινήστε το Nginx.
sudo sysrc nginx_enable=yes sudo service nginx start
Εκτελέστε sudo vim /usr/local/etc/nginx/monica.conf
και ρυθμίστε το Nginx για τη Μόνικα.
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; } }
Αποθηκεύστε το αρχείο και βγείτε.
Τώρα πρέπει να συμπεριλάβουμε monica.conf
στο κύριο nginx.conf
αρχείο.
Εκτελέστε sudo vim /usr/local/etc/nginx/nginx.conf
και προσθέστε την ακόλουθη γραμμή στο http {}
μπλοκ.
include monica.conf;
Δοκιμάστε τη διαμόρφωση.
sudo nginx -t
Επαναφόρτωση Nginx.
sudo service nginx reload
Εγκαταστήστε το Composer
Εγκαταστήστε το Composer παγκοσμίως.
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
Ελέγξτε την έκδοση.
composer --version # Composer version 1.8.6 2019-06-11 15:03:05
Εγκαταστήστε και διαμορφώστε τη Monica
Δημιουργήστε έναν κενό ριζικό φάκελο εγγράφων όπου θα πρέπει να εγκατασταθεί η Monica.
sudo mkdir -p /usr/local/www/monica
Μεταβείτε στον ριζικό φάκελο του εγγράφου.
cd /usr/local/www/monica
Αλλαγή ιδιοκτησίας /usr/local/www/monica
φακέλου σε χρήστη johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/monica
Κλωνοποιήστε το αποθετήριο Monica σε αυτό.
git clone https://github.com/monicahq/monica.git . git checkout tags/v2.14.0
ΣΗΜΕΙΩΣΗ: Βρείτε την πιο πρόσφατη επίσημη έκδοση στη σελίδα εκδόσεων στο GitHub και ενημερώστε τον παραπάνω αριθμό έκδοσης στην πιο πρόσφατη έκδοση.
Εκτελέστε τα παρακάτω για να δημιουργήσετε τη δική σας έκδοση των μεταβλητών περιβάλλοντος που απαιτούνται για το έργο.
cp .env.example .env
Ενημερώστε το .env
αρχείο στις συγκεκριμένες ανάγκες σας. Μην ξεχάσετε να ορίσετε DB_USERNAME
και DB_PASSWORD
με τις ρυθμίσεις που χρησιμοποιήθηκαν προηγουμένως.
Εγκαταστήστε όλα τα πακέτα.
composer install --no-interaction --no-suggest --no-dev
Δημιουργήστε ένα κλειδί εφαρμογής. Αυτό θα ρυθμιστεί APP_KEY
αυτόματα στη σωστή τιμή.
php artisan key:generate
Εκτελέστε τις μετεγκαταστάσεις και δημιουργήστε τη βάση δεδομένων και τους φακέλους συμβολικών συνδέσμων.
php artisan setup:production -v
Αλλάξτε την ιδιοκτησία του /usr/local/www/monica
καταλόγου σε www
.
sudo chown -R www:www /usr/local/www/monica
Η εγκατάσταση ολοκληρώθηκε. Ανοίξτε τον τομέα σας στο πρόγραμμα περιήγησής σας και ακολουθήστε τις οδηγίες που εμφανίζονται στην οθόνη.