كيفية تثبيت مونيكا على أوبونتو 18.04 LTS

• المتطلبات
• قم بتثبيت PHP
• تثبيت MySQL وإعداد قاعدة بيانات
• قم بتثبيت وتكوين Nginx
• قم بتثبيت Node.js و NPM
• قم بتثبيت الملحن
• تثبيت وتكوين مونيكا

مونيكا هو نظام إدارة علاقات شخصية مفتوح المصدر. فكر في الأمر على أنه CRM (أداة شائعة تستخدمها فرق المبيعات في عالم الشركات) لأصدقائك أو عائلتك. يتم استضافة رمز المصدر الخاص به علانية على GitHub . في هذا الدليل ، سوف نستعرض عملية تثبيت تطبيق مونيكا.

المتطلبات

• خادم Ubuntu 18.04 LTS (Bionic Beaver)
• شخص سخيف
• NPM (مدير حزمة العقدة)
• PHP 7.1+ أو أحدث
• MySQL
• Nginx
• ملحن

ملاحظة حول Git : غالبًا ما يتم تثبيت Git بالفعل على خادم Ubuntu. إذا لم يكن الأمر كذلك ، فيمكنك تثبيته بسهولة عن طريق تشغيل:sudo apt install -y git

تحقق من إصدار Ubuntu.

lsb_release -ds
# Ubuntu 18.04 LTS

قم بإنشاء non-rootحساب مستخدم جديد له sudoحق الوصول والتبديل إليه.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

ملاحظة : استبدل johndoeباسم المستخدم الخاص بك .

قم بإعداد المنطقة الزمنية.

sudo dpkg-reconfigure tzdata

تأكد من أن نظامك محدث.

sudo apt update && sudo apt upgrade -y

تثبيت build-essentialو libpng-dev.

sudo apt install -y build-essential libpng-dev

قم بتثبيت PHP

قم بتثبيت PHP 7.2 وملحقات PHP المطلوبة.

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-xml php7.2-mysql php7.2-curl php7.2-zip php7.2-intl

التحقق من إصدار.

php --version

# PHP 7.2.5-0ubuntu0.18.04.1 (cli) (built: May  9 2018 17:21:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.5-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

تثبيت MySQL وإعداد قاعدة بيانات

تثبيت MySQL.

sudo apt install -y mysql-server

التحقق من إصدار.

mysql --version
# mysql  Ver 14.14 Distrib 5.7.22, for Linux (x86_64) using  EditLine wrapper

قم بتشغيل mysql_secure installationالبرنامج النصي لتحسين أمان MySQL وتعيين كلمة المرور rootلمستخدم MySQL .

sudo mysql_secure_installation

اتصل بقشرة MySQL كمستخدم أساسي.

sudo mysql -u root -p
# Enter password

إنشاء قاعدة بيانات MySQL فارغة ومستخدم لمونيكا ، وتذكر أوراق الاعتماد.

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

قم بتثبيت وتكوين Nginx

قم بتثبيت Nginx.

sudo apt install -y nginx

التحقق من إصدار.

sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)

قم بتشغيل sudo vim /etc/nginx/sites-available/monica.confوتكوين Nginx لمونيكا.

server {
    listen 80;
    listen [::]:80;

    server_name example.com;
    root /var/www/monica/public;

    index index.php;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    }
}

احفظ الملف واخرج.

قم بتنشيط monica.confالتكوين الجديد عن طريق ربط الملف sites-enabledبالدليل.

sudo ln -s /etc/nginx/sites-available/monica.conf /etc/nginx/sites-enabled/

اختبر التكوين.

sudo nginx -t

إعادة تحميل Nginx.

sudo systemctl reload nginx.service

قم بتثبيت Node.js و NPM

تثبيت Node.js.

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs

تحقق من إصدارات Node.js و npm.

node -v && npm -v
# v10.2.1
# 5.6.0

قم بتثبيت الملحن

قم بتثبيت الملحن.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { 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.6.5 2018-05-04 11:44:59

تثبيت وتكوين مونيكا

قم بإنشاء مجلد جذر مستند فارغ حيث يجب تثبيت مونيكا.

sudo mkdir -p /var/www/monica

انتقل إلى مجلد جذر المستند.

cd /var/www/monica

تغيير ملكية /var/www/monicaالمجلد إلى المستخدم johndoe.

sudo chown -R johndoe:johndoe /var/www/monica

استنساخ مستودع مونيكا لها.

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

ملاحظة : ابحث عن أحدث إصدار رسمي في صفحة الإصدارات على GitHub وقم بتحديث رقم الإصدار أعلاه إلى أحدث إصدار.

قم بتشغيل ما يلي لإنشاء نسختك الخاصة من متغيرات البيئة اللازمة للمشروع.

cp .env.example .env

قم بتحديث .envالملف لاحتياجاتك الخاصة. لا تنسى أن مجموعة DB_USERNAMEو DB_PASSWORDمع الإعدادات المستخدمة سابقا.

قم بتثبيت جميع الحزم.

composer install --no-interaction --no-suggest --no-dev --ignore-platform-reqs

قم بتثبيت كافة التبعيات والأدوات الأمامية اللازمة لتجميع الأصول.

npm install yarn
npm install

تجميع أصول JS و CSS.

npm run production

أنشئ مفتاح تطبيق. سيتم تعيين ذلك APP_KEYعلى القيمة الصحيحة تلقائيًا.

php artisan key:generate

شغّل عمليات الترحيل وأصل مجلدات قاعدة البيانات ورمز الارتباط.

php artisan setup:production

تغيير ملكية /var/www/monicaالدليل إلى www-data.

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

المشكلة المحتملة: تم vue-directive-tooltipتغيير بنية الدليل في حزمة NPM ، لكن monicahqالتكوين لم يغيرها بعد (اعتبارًا من 09/2019). لإصلاح ذلك ، /var/www/monica/resources/assets/js/app.jsيجب تغيير السطر التالي من:

import 'vue-directive-tooltip/css/index.css'
to
import 'vue-directive-tooltip/src/css/index.css'

اكتمال التثبيت. افتح المجال الخاص بك في متصفح الويب الخاص بك واتبع التعليمات الموضحة على الشاشة.