Monica është një sistem i menaxhimit të marrëdhënieve personale me burim të hapur. Mendoni si një CRM (një mjet popullor i përdorur nga ekipet e shitjeve në botën e korporatave) për miqtë ose familjen tuaj. Kodi burimor i tij është i pritur publikisht në GitHub . Në këtë udhëzues, ne do të shqyrtojmë procesin e instalimit të një aplikacioni Monica.
Kërkesat
- Sistemi FreeBSD 12
- Git
- Versioni PHP 7.2 ose më i ri me shtesat e mëposhtme të PHP:
- json
- ikonv
- ndert
- opcache
- mbstring
- xml
- mysqli
- pdo_mysql
- bcmath
- kaçurrela
- gmp
- zip
- gd
- MariaDB
- Nginx
- Kompozitor
Perpara se te fillosh
Kontrolloni versionin e FreeBSD.
uname -ro # FreeBSD 12.0-RELEASE
Sigurohuni që sistemi juaj FreeBSD të jetë i përditësuar.
freebsd-update fetch install pkg update && pkg upgrade -y
Instaloni paketat e nevojshme.
pkg install -y sudo vim unzip curl wget bash socat git libpng-dev
Krijo një llogari të re përdoruesi me emrin e përdoruesit të preferuar. ne do të përdorim 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!
Ekzekutoni visudokomandën dhe hiqni komentin e %wheel ALL=(ALL) ALLlinjës, për të lejuar anëtarët e wheelgrupit të ekzekutojnë çdo komandë.
visudo # Uncomment by removing hash (#) sign # %wheel ALL=(ALL) ALL
Tani, kaloni te përdoruesi juaj i sapokrijuar me su.
su - johndoe
SHËNIM: Zëvendësojeni johndoeme emrin tuaj të përdoruesit.
Vendosni zonën kohore.
sudo tzsetup
Instaloni PHP
Instaloni PHP, si dhe shtesat e nevojshme 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
Kontrolloni versionin.
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
Lidhja e butë php.ini-productionme php.ini.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Aktivizo dhe nis PHP-FPM.
sudo sysrc php_fpm_enable=yes sudo service php-fpm start
Instaloni MariaDB dhe konfiguroni një bazë të dhënash
Instaloni MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Kontrolloni versionin.
mysql --version # mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Filloni dhe aktivizoni MariaDB.
sudo sysrc mysql_enable="yes" sudo service mysql-server start
Ekzekutoni mysql_secure_installationskriptin për të përmirësuar sigurinë e instalimit tuaj.
sudo mysql_secure_installation
Hyni në MariaDB si përdoruesi rrënjë.
mysql -u root -p # Enter password:
Krijoni një bazë të dhënash dhe përdorues të ri. Mbani mend kredencialet për këtë përdorues të ri.
CREATE DATABASE dbname; GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; exit;
Instaloni dhe konfiguroni Nginx
Instaloni Nginx.
sudo pkg install -y nginx
Kontrolloni versionin.
nginx -v # nginx version: nginx/1.14.2
Aktivizo dhe nis Nginx.
sudo sysrc nginx_enable=yes sudo service nginx start
Drejtoni sudo vim /usr/local/etc/nginx/monica.confdhe konfiguroni Nginx për Monica.
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; } }
Ruani skedarin dhe dilni.
Tani duhet të përfshijmë monica.confnë nginx.confskedarin kryesor .
Ekzekutoni sudo vim /usr/local/etc/nginx/nginx.confdhe shtoni rreshtin e mëposhtëm në http {}bllok.
include monica.conf;
Testoni konfigurimin.
sudo nginx -t
Rifresko Nginx.
sudo service nginx reload
Instaloni Composer
Instaloni Composer globalisht.
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
Kontrolloni versionin.
composer --version # Composer version 1.8.6 2019-06-11 15:03:05
Instaloni dhe konfiguroni Monica
Krijoni një dosje të zbrazët rrënjësore të dokumentit ku duhet të instalohet Monica.
sudo mkdir -p /usr/local/www/monica
Navigoni te dosja rrënjë e dokumentit.
cd /usr/local/www/monica
Ndrysho pronësinë e /usr/local/www/monicadosjes në përdorues johndoe.
sudo chown -R johndoe:johndoe /usr/local/www/monica
Klononi depon e Monica në të.
git clone https://github.com/monicahq/monica.git . git checkout tags/v2.14.0
SHËNIM: Gjeni versionin më të fundit zyrtar në faqen e publikimeve në GitHub dhe përditësoni numrin e versionit të mësipërm në versionin më të fundit.
Ekzekutoni sa vijon për të krijuar versionin tuaj të variablave të mjedisit të nevojshëm për projektin.
cp .env.example .env
Përditësoni .envskedarin sipas nevojave tuaja specifike. Mos harroni të vendosni DB_USERNAMEdhe DB_PASSWORDme cilësimet e përdorura më parë.
Instaloni të gjitha paketat.
composer install --no-interaction --no-suggest --no-dev
Gjeneroni një çelës aplikacioni. Kjo do të vendoset APP_KEYnë vlerën e saktë automatikisht.
php artisan key:generate
Ekzekutoni migrimet dhe vendosni bazën e të dhënave dhe dosjet e lidhjeve simbolike.
php artisan setup:production -v
Ndrysho pronësinë e /usr/local/www/monicadrejtorisë në www.
sudo chown -R www:www /usr/local/www/monica
Instalimi ka përfunduar. Hapni domenin tuaj në shfletuesin tuaj të internetit dhe ndiqni udhëzimet e shfaqura në ekran.