Getting start

نصب و راه‌اندازی یک نمونه سرور مراحل زیر رو داره:

• ایجاد پایگاه داده
• ایجاد یک هاست
• تنظیم پایگاه داده
• نصب و اجرا

توی این مستند سعی شده که این مراحل با زبان ساده تشریح بشه. سیستم عاملی که برای نصب در نظر گرفته شده OpenSuse هست. اما اکثر کارهایی که برای کار لازمه توی تمام سیستم‌های عامل مشابه هست.

##‌ ایجاد پایگاه داده

ما برای کار یک پایگاه داده ایجاد می‌کنیم اما شما می‌توانید از پایگاه‌های داده موجود هم برای این کار استفاده کنید.

این کار رو به صورت کامند انجام می‌دیم اما شما می‌تونید از ابزارهای گرفیکی برای این کار استفاده کنید.

اول از همه به پیاگاه داده وارد بشید:

mysql -u root
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 5
Server version: 10.0.27-MariaDB SLE 12 SP1 package

Copyright (c) 2000, 2016, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [(none)]> 

من فرض کردم که کاربر root وجود داره و برای دسترسی به پایگاه داده به پسوردی نیاز نداره. در صورتی که کاربر شما فرق داره و یا پسورد نیاز داره باید بر اساس مستندهای ارائه شده از گروه MySql این کار رو انجام بدید.

در گام بعد یک پایگاه داده به نام pluf ایجاد میکنم. از این پایگاه داده برای راه اندازی سایت استفاده خواهم کرد.

MariaDB [(none)]> CREATE SCHEMA pluf;
Query OK, 1 row affected (0.00 sec)

من با همین کاربری که پایگاه داده رو ایجاد کرده به پایگاه داده متصل خواهم شده، از همین رو نیازی ندارم که دسترسی به این پایگاه داده رو تنظیم کنم. اما اگر شما میخواهید با کاربر دیگه ای وارد بشید باید این تنظیم ها رو بر اساس مستند MySql انجام بدید.

دیگه کارمون با پایگاه داده تموم شده.

ایجاد هاست

کاری که اینجا می‌خوام انجام بدم ایجاد یه هاست مجازی روی apache هست. این هاست در حقیقت جایی هست که ما می‌خواهیم برنامه خودمون رو نصب و راه اندازی کنیم. بر اساس تجربه‌های کاری که داشتم پیشنهاد می‌کنم که یه پوشه برای هاست ایجاد کنید و ساختار پوشه‌ای زیر رو توش ایجاد کنید:

/home/maso/git/Pluf/site/
├── etc
├── src
├── tenant
│   ├── avatar
│   ├── cms
│   ├── sdp
│   └── spa
├── var
│   ├── backup
│   ├── logs
│   └── tmp
└── www

این ساختار رو توی پروژه ایجاد کردم. ازش یه کپی توی مسیری که می‌خواهید ایجاد کنید.

حالا برای اضافه کردن تنظیم‌ها باید فایل زیر رو پیدا کنید

/etc/apache2/vhosts.d/ip-based_vhosts.conf

توی سیستم‌های عامل متفاوت مسیر این فایل فرق داره و یا حتی ممکن هست اسمش هم متفاوت باشه. به هر حال می‌تونید توی گوگل عبارت زیر رو جستجو کنید:

ip based virtual host apache2

تنظیم‌هایی که باید اضافه کنید:

<VirtualHost *:8945>
    DocumentRoot /home/maso/git/Pluf/site/www/
    ServerName pluf-test
    ServerAdmin info@localhost
    <Directory /home/maso/git/Pluf/site/www/>
        AllowOverride All
        Order allow,deny
        Allow from all
        Options +FollowSymLinks
        Require all granted
    </Directory>
</VirtualHost>

ماژول‌های زیر رو هم باید فعال کرده باشید

• Rewrite

التبه تمام این تنظیم‌ها توی پنل‌های CPanel‌ هست و شما نیازی به این کارها ندارید و تنها کاری که باید بکنید یه کپی است.

با این کار هاست ایجاد شده و کافی هست که سرور رو ریست کنید.

تنظیم پایگاه داده

توی فایل‌هایی که کپی کردید یه فایل توی مسیر زیر هست:

src/confg.php

این فایل کل تنظیم‌های سیستم هست. این فایل رو باز کنید و یه بخش برای تنظیم‌های mysql هست. اون رو به صورت زیر اصلاح کنید:

/*
* نوع و نسخه پایگاه داده باید تعیین شود تا اتصال به آن بدون مشکل انجام شود.
* معمولا
* در نرم‌افزارها از پایگاه داده MySql‌ استفاده می‌کنیم برای همین ضمانتی برای
* پایگاه‌های
* دیگر وجود ندارد.
*/
$cfg['db_version'] = '5.5.33';
$cfg['db_engine'] = 'MySQL';

/*
* برای دسترسی به پایگاه داده یک نام کاربری، گذرواژه، آدرس پایگاه داده و نام آن
* مورد نیاز است. در این قسمت ابتدا تمام اطلاعات مورد نیاز برای اتصال به پایگاه
* داده تعیین می‌شود.
*/
$cfg['db_login'] = 'root';
$cfg['db_password'] = '';
$cfg['db_server'] = 'localhost';
$cfg['db_database'] = 'pluf';

/*
* گاهی نیاز است که در یک پایگاه داده چندین نرم‌افزار را نصب کرد از این رو به هر
* یک از این نرم‌افزارهای کاربردی می‌توان یک پیش وند اضافه کرد و بدون نگرانی از
* تداخل آنها، از آنها استفاده کرد.
*/
$cfg['db_table_prefix'] = '';

البته ممکن هست هر تنظیم دیگه‌ای انجام بدید.

نصب و راه اندازی

فرآیند نصب با اسکریپت‌هایی انجام می‌شه که توی مسیر www ایجاد شده. فایل زیر رو باز کنید:

www/index.php

و محتوی اون رو به صورت زیر تغییر بدید:

<?php
/*
* مسیر اصلی که پروژه pluf رو توش کلون کردید رو باید بدید. نکته اینکه مسیر پوشه src موجود در پروژه باید باشه.
*/
define ( "PLUF_BASE", '/path/to/Pluf/src' );
// اینها رو تغییر ندید
define ( "SRC_BASE", dirname ( __FILE__ ) . '/..' );
include 'index.install.php';

حالا اگه یک کاوشگر باز کنید و آدرس زیر رو وارد کنید همه چیز توی پایگاه داده ایجاد می‌شه:

http://localhost:8945

ممکن هست خطا بده در این صورت باید کل پایگاه داده رو حذف کنید و دوباره ایجاد کنید و بعد از رفع خطا این کار رو تکرار کنید.

در نهایت محتوی فایل index.php رو به حالت زیر برگردونید:

<?php
/*
* مسیر اصلی که پروژه pluf رو توش کلون کردید رو باید بدید. نکته اینکه مسیر پوشه src موجود در پروژه باید باشه.
*/
define ( "PLUF_BASE", '/path/to/Pluf/src' );


define ( "SRC_BASE", dirname ( __FILE__ ) . '/..' );
include 'index.default.php';