آموزش کار با دیتابیس mongodb در php

با بخش دوم از آموزش کار با دیتابیس mongodb در php در خدمت شما هستیم.

در بخش اول مقاله آموزش mongoDb با نحوه کار این دیتابیس, مفاهیم پایه و نحوه نصب آن روی پلتفرم های مختلف را دیدیم.

در بخش دوم قصد داریم بطور عملی از دیتابیس MongoDB در PHP استفاده کنیم.

نصب درایور PHP برای دیتابیس MongoDB

سرور MongoDB از قبل با وب سرور پیش فرض شما کار میکند اما با PHP نه. بنابراین برای ارتباط به سرور MongoDB از طریق PHP , نیاز است که درایور آن را نصب کنیم که بصورت یک کتابخانه اکستنشن برای PHP است.

اگر از لینوکس استفاده می کنید دستور زیر را در ترمینال اجرا کنید

sudo pecl install mongo

1	sudo pecl install mongo

سپس خط extension=mongo.so را در فایل پیکربندی php.ini بصورت زیر اضافه کنید

sudo -i
echo 'extension=mongo.so' >> /etc/php5/apache2/php.ini

1 2	sudo -i echo 'extension=mongo.so' >> /etc/php5/apache2/php.ini

سپس وب سرور را ریستارت و وریفای کنید:

php -i |grep "mongo"
php --re mongo

1 2	php -i \|grep "mongo" php --re mongo

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

فایل فشرده را دانلود کنید. https://github.com/mongodb/mongo-php-driver/releases
فایل php_mongo.dll را از فولدر استخراج شده در دایرکتری php نصب شده کپی کنید (در اینجا ازxampp استفاده می کنیم پس فولدر ما C:\xampp\php\ext است.)
فایل php.ini را از داخل فولدر php نصب شده باز کنید و این خط را اضافه کنید : extension=php_mongo.dll
فایل را ذخیره و XAMPP را ریستارت کنید
بعد از آن تابع phpinfo() را اجرا کنید و عبارت mongo را جستجو کنید تا از نصب شدن آن مطمین شوید.

کار با دیتابیس mongodb در php

اتصال به دیتابیس MongoDB

اتصال به MongoDB از PHP بسیار شبیه اتصال به هر دیتابیس دیگری است. هاست پیش فرض localhost و پورت پیش فرض نیز ۲۷۰۱۷ است.

$connection = new Mongo();

1	$connection = new Mongo();

اتصال به هاست ریموت با اطلاعات ورود :

$connecting_string =  sprintf('mongodb://%s:%d/%s', $hosts, $port,$database),
$connection=  new Mongo($connecting_string,array('username'=>$username,'password'=>$password));

1 2	$connecting_string = sprintf('mongodb://%s:%d/%s', $hosts, $port,$database), $connection= new Mongo($connecting_string,array('username'=>$username,'password'=>$password));

انتخاب یک دیتابیس

همین که کانکشن سرور دیتابیس برقرار شد, از آن برای دسترسی به یک دیتابیس استفاده می کنیم :

$dbname = $connection->selectDB('dbname');

1	$dbname = $connection->selectDB('dbname');

عملیات CRUD دیتابیس MongoDB در PHP

دیتابیس مانگو دستورات بسیار معناگرایانه و ساده ای برای خواندن و دستکاری داده های در اختیار ما قرار می دهد.

CURD مخفف عملیات Create (ساختن), read(خواندن), Update(بروزرسانی), Delete(حذف) است. این مفاهیم پایه تمام عملیات کار با دیتابیس می باشد.

ایجاد/انتخاب یک کالکشن (Collection)

انتخاب و ساخت یک کالکشن بسیار مشابه ساخت یک دیتابیس است. اگر کالکشن مورد نظر وجود نداشته باشد, آن را می سازد.

$collection = $dbname->collection;
//or
$collection = $dbname->selectCollection('collection');

$collection = $dbname->collection;

//or

$collection = $dbname->selectCollection('collection');

برای مثال به منظور ساخت کالکشن posts به اینصورت عمل می کنیم

$posts = $dbname->posts

1	$posts = $dbname->posts

ساخت یک سند (Document)

ایجاد یک سند در دیتابیس MongoDB از این ساده تر نمی تواند باشد.

کافیه یک آرایه را ساخته و به متد insert بر روی آبجکت کالکشن پاس بدید همین.

$post = array(
        'title'     => 'What is MongoDB',
        'content'   => 'MongoDB is a document database that provides high performance...',
        'saved_at'  => new MongoDate() 
    );
    $posts->insert($post);

$post = array(

'title' => 'What is MongoDB',

'content' => 'MongoDB is a document database that provides high performance...',

'saved_at' => new MongoDate()

);

$posts->insert($post);

متد insert() داده ها را در collection ذخیره می کند. آرایه $post بصورت خوکار یک نام فیلد به نام _id اضافه می کند که یک آبجکت آی دی منحصر به فرد را در داکیومنت BSON قرار می دهد.

همچنین می توانید از متد save() نیز برای بروزرسانی یک رکورد از پیش وجود داشته و یا اگر وجود نداشت ساخت آن استفاده کنید.

خواندن یک سند (Document)

برای دریافت داده ها از یک کالکشن, از متد find() استفاده می کنیم که تمام داده ها در کالکشن را برگشت می دهد. findOne() نیز فقط یک داکیومنت را برگشت می دهد.

مثال زیر به شما نحوه نمایش رکورد ها توسط هر دو متد بالا را نشان می دهد.

 // all records
    $result = $posts::find();
    // one record
    $id = '52d68c93cf5dc944128b4567';
    $results = $posts::findOne(array('_id' => new MongoId($id)));

// all records

$result = $posts::find();

// one record

$id = '52d68c93cf5dc944128b4567';

$results = $posts::findOne(array('_id' => new MongoId($id)));

بروزرسانی (Update) یک سند

بطور پیشفرض متد update() یک سند را بروزرسانی می کند. اگر چند آپشن ست شده باشد پس همه داکیومنت ها را در یک کوئری شاخص آپدیت می کند.

 $id = '52d68c93cf5dc944128b4567';
    $posts->update(
        array('_id'     => new MongoId($id)),
    array('$set'    => array(title'   => 'What is phalcon'))
    );

$id = '52d68c93cf5dc944128b4567';

$posts->update(

array('_id' => new MongoId($id)),

array('$set' => array(title' => 'What is phalcon'))

);

متد update() دو پارامتر را می پذیرد. اولی شاخص معرفی آبجکت برای آپدیت و دومی نیز آبجکتی که با رکوردهای مورد نظر تطابق دارد را مشخصئ می کند.

همچنین پارامتر اختیاری سومی نیز وجود دارد که می توانید یک آرایه از آپشن ها را پاس بدید.

مینی پروژه ساخت وبلاگ

ساختار پروژه ما بصورت زیر است:

    |-------admin
            |------index.php                    # This is dashboard
            |------auth.php
    |-------view
            |------admin
                    |-------create.view.php     #form create article
                    |-------dashbroad.view.php
            |------index.view.php               
            |------layout.php       #This is main layout it will be shown for every  action executed within the app
            |------single.view.php              # This is view for a single article
    |-------config.php                          # Define paramater database, url
    |-------app.php                             # Include multi-php files
    |-------db.php                        # Container class db 
    |-------index.php
    |-------single.php
    |-------static                              # Container css,js...
                |-----css
                |-----js
    |-------vendor
                |----markdown                   # Library converts markdown into html

|-------admin

|------index.php # This is dashboard

|------auth.php

|-------view

|------admin

|-------create.view.php #form create article

|-------dashbroad.view.php

|------index.view.php

|------layout.php #This is main layout it will be shown for every action executed within the app

|------single.view.php # This is view for a single article

|-------config.php # Define paramater database, url

|-------app.php # Include multi-php files

|-------db.php # Container class db

|-------index.php

|-------single.php

|-------static # Container css,js...

|-----css

|-----js

|-------vendor

|----markdown # Library converts markdown into html

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

فایل config.php

این فایل پیکربندی به شما نحوه اتصال به دیتابیس mongoDB در PHP را نشان می دهد.

<?php
        define('URL', 'http://localhost/netpradis/blog-mongodb');
        define('UserAuth', 'admin');
        define('PasswordAuth', '');

        $config = array(
            'username' => 'root',
            'password' => 'qazws@',
            'dbname'   => 'blog',
            'connection_string'=> sprintf('mongodb://%s:%d/%s','127.0.0.1','27017','blog')
        );

<?php

define('URL', 'http://localhost/netpradis/blog-mongodb');

define('UserAuth', 'admin');

define('PasswordAuth', '');

$config = array(

'username' => 'root',

'password' => 'qazws@',

'dbname' => 'blog',

'connection_string'=> sprintf('mongodb://%s:%d/%s','127.0.0.1','27017','blog')

);

برای قرار دادن رمزعبور و احراز هویت HTTP روی فولدر پنل مدیریت دو پارامتر UserAuth, PasswordAuth را تعریف کردیم.

فایل app.php

    <?php
    include 'config.php';
    include 'layout.php';
    include 'db.php';

    use Blog\DB,
        Blog\Layout;

    // Constructor to the db
    $db = new DB\DB($config);

    // Constructor to layout view
    $layout = new Layout\Layout();

<?php

include 'config.php';

include 'layout.php';

include 'db.php';

use Blog\DB,

Blog\Layout;

// Constructor to the db

$db = new DB\DB($config);

// Constructor to layout view

$layout = new Layout\Layout();

فولدر admin

این فولدر دارای فایل index.php شامل کدهای انحام عملیات CRUD است.

<?php
require_once 'auth.php';
require_once '../app.php';
require_once '../vendor/markdown/Markdown.inc.php';
use \Michelf\MarkdownExtra,
    \Michelf\Markdown;

if ((is_array($_SESSION) && $_SESSION['username'] == UserAuth)) {
    $data = array();
    $status = (empty($_GET['status'])) ? 'dashboard' : $_GET['status'];
    switch ($status) {
        //create post
        case 'create':
            break;
        //edit post
        case 'edit':
            break;
        //delete post
        case 'delete':
            //display all post in dashboard
        default:
            $currentPage = (isset($_GET['page'])) ? (int)$_GET['page'] : 1;
            $data = $db->get($currentPage, 'posts');

            $layout->view('admin/dashboard', array(
                'currentPage' => $data[0],
                'totalPages' => $data[1],
                'cursor' => $data[2]
            ));
            break;
    }
}

<?php

require_once 'auth.php';

require_once '../app.php';

require_once '../vendor/markdown/Markdown.inc.php';

use \Michelf\MarkdownExtra,

\Michelf\Markdown;

if ((is_array($_SESSION) && $_SESSION['username'] == UserAuth)) {

$data = array();

$status = (empty($_GET['status'])) ? 'dashboard' : $_GET['status'];

switch ($status) {

//create post

case 'create':

break;

//edit post

case 'edit':

break;

//delete post

case 'delete':

//display all post in dashboard

default:

$currentPage = (isset($_GET['page'])) ? (int)$_GET['page'] : 1;

$data = $db->get($currentPage, 'posts');

$layout->view('admin/dashboard', array(

'currentPage' => $data[0],

'totalPages' => $data[1],

'cursor' => $data[2]

));

break;

}

کد index.php بالا کامل نیست و کد کامل به همراه سورس کد نهایی از بخش باکس دانلود در دسترس است.

در بالا از تابع view در کلاس layout.php است که بطور خودکار فایل dashboard.view.php را لود می کند.

<?php namespace Blog\Layout;

Class Layout
{

    /**
     * @var array
     */
    public $data;

    public function view($path, $data)
    {
        if (isset($data)) {
            extract($data);
        }
        $path .= '.view.php';
        include "views/layout.php";
    }
}

<?php namespace Blog\Layout;

Class Layout

{

/**

* @var array

public $data;

public function view($path, $data)

{

if (isset($data)) {

extract($data);

}

$path .= '.view.php';

include "views/layout.php";

}

از پارامتر status به منظور انجام عملیات CRUD استفاده می شود. بطور مثال زمانی که مقدار status برابر create باشد:

if ($_SERVER['REQUEST_METHOD'] === 'POST') {

    $article = array();
    $article['title'] = $_POST['title'];
    $article['content'] = Markdown::defaultTransform($_POST['content']);
    $article['saved_at'] = new MongoDate();

    if (empty($article['title']) || empty($article['content'])) {
        $data['status'] = 'Please fill out both inputs.';
    } else {

// then create a new row in the collection posts
        $db->create('posts', $article);
        $data['status'] = 'Row has successfully been inserted.';
    }
}
$layout->view('admin/create', $data);

if ($_SERVER['REQUEST_METHOD'] === 'POST') {

$article = array();

$article['title'] = $_POST['title'];

$article['content'] = Markdown::defaultTransform($_POST['content']);

$article['saved_at'] = new MongoDate();

if (empty($article['title']) || empty($article['content'])) {

$data['status'] = 'Please fill out both inputs.';

} else {

// then create a new row in the collection posts

$db->create('posts', $article);

$data['status'] = 'Row has successfully been inserted.';

}

$layout->view('admin/create', $data);

تابع view(“admin/create”,$date) یک فرم HTML را که کاربر عنوان و محتوای پست جدید وبلاگ را می نویسد, نشان می دهد. یا اطلاعات سابمیت شده توسط کاربر را در دیتابیس mongoDB ذخیره می کند.

بطور پیش فرض اسکریپت فرم HTML زیر را نشان می دهد:

<form action="" method="post">
    <div><label for="Title">Title</label>
        <input type="text" name="title" id="title" required="required"/>
    </div>
    <label for="content">Content</label>

    <p><textarea name="content" id="content" cols="40" rows="8" class="span10"></textarea></p>

    <div class="submit"><input type="submit" name="btn_submit" value="Save"/></div>
</form>

<div><label for="Title">Title</label>

</div>

<label for="content">Content</label>

</form>

بخشی از فایل db.php را می بینید:

<?php 

namespace Blog\DB;

class DB
{

    /**
     * Return db
     * @var object
     */
    private $db;

    /**
     * Results limit.
     * @var integer
     */
    public $limit = 5;


    public function __construct($config)
    {

        $this->connect($config);
    }

    //connecting mongodb
    private function connect($config)
    {
    }

    //get all data
    public function get($page, $collection)
    {
    }

    //get one data by id
    public function getById($id, $collection)
    {
    }

    //create article
    public function create($collection, $article)
    {
    }

    //delete article by id
    public function delete($id, $collection)
    {
    }

    //update article
    public function update($id, $collection, $acticle)
    {
    }

    //create and update comment
    public function commentId($id, $collection, $comment)
    {
    }
}

<?php

namespace Blog\DB;

class DB

{

/**

* Return db

* @var object

private $db;

/**

* Results limit.

* @var integer

public $limit = 5;

public function __construct($config)

{

$this->connect($config);

}

//connecting mongodb

private function connect($config)

{

}

//get all data

public function get($page, $collection)

{

}

//get one data by id

public function getById($id, $collection)

{

}

//create article

public function create($collection, $article)

{

}

//delete article by id

public function delete($id, $collection)

{

}

//update article

public function update($id, $collection, $acticle)

{

}

//create and update comment

public function commentId($id, $collection, $comment)

{

}

فایل های قالب را می توانید در فولدر view پیدا کنید. مثلا index.view.php . مثالی از فایل index.php :

public function get($page,$collection){

        $currentPage = $page;
        $articlesPerPage = $this->limit;

        //number of article to skip from beginning
        $skip = ($currentPage - 1) * $articlesPerPage; 

        $table = $this->db->selectCollection($collection);
    $cursor = $table->find();

        //total number of articles in database
        $totalArticles = $cursor->count(); 

        //total number of pages to display
        $totalPages = (int) ceil($totalArticles / $articlesPerPage); 

        $cursor->sort(array('saved_at' => -1))->skip($skip)->limit($articlesPerPage);

        $data=array($currentPage,$totalPages,$cursor);

    return $data;
}

public function get($page,$collection){

$currentPage = $page;

$articlesPerPage = $this->limit;

//number of article to skip from beginning

$skip = ($currentPage - 1) * $articlesPerPage;

$table = $this->db->selectCollection($collection);

$cursor = $table->find();

//total number of articles in database

$totalArticles = $cursor->count();

//total number of pages to display

$totalPages = (int) ceil($totalArticles / $articlesPerPage);

$cursor->sort(array('saved_at' => -1))->skip($skip)->limit($articlesPerPage);

$data=array($currentPage,$totalPages,$cursor);

return $data;

}

Single.php : زمانی که صفحه یک پست را باز می کنید (کلیک روی گزینه Read more). منطق فایل single.php بصورت زیر است :

<?php

require 'app.php';
// Fetch the entire post
$post = $db->getById($_GET['id'], 'posts');
if ($post) {
    $layout->view('single', array(
        'article' => $post
    ));
}

<?php

require 'app.php';

// Fetch the entire post

$post = $db->getById($_GET['id'], 'posts');

if ($post) {

$layout->view('single', array(

'article' => $post

));

}

این فایل _id مقاله را از طریق پارامتر GET دریافت می کند. ما متد findOne() روی کالکشن articles اجرا می کنیم.

متد findOne() برای دریافت یک سند (document) تنها اجرا می کنیم. تابع getById() در فایل db.php است.

یک نام و ایمیل را در فیلد های ورودی زیر بخش کامنت ها وارد کنید, مقداری متن را در textarea بنویسید. سپس روی دکمه Save کلیک و نظر شما با لود صفحه ذخیره می شود.

فایل comment.php بصورت زیر است :

<?php

require 'app.php';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {

    $id = $_POST['article_id'];
    $comment = array(
        'name' => $_POST['fName'],
        'email' => $_POST['fEmail'],
        'comment' => $_POST['fComment'],
        'posted_at' => new MongoDate()
    );
    $status = $db->commentId($id, 'posts', $comment);

    if ($status == TRUE) {
        header('Location: single.php?id=' . $id);
    }
}

<?php

require 'app.php';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {

$id = $_POST['article_id'];

$comment = array(

'name' => $_POST['fName'],

'email' => $_POST['fEmail'],

'comment' => $_POST['fComment'],

'posted_at' => new MongoDate()

);

$status = $db->commentId($id, 'posts', $comment);

if ($status == TRUE) {

header('Location: single.php?id=' . $id);

}

کامنت ها برای یک مقاله در یک آرایه فیلد در داکیومنت comments ذخیره می شود.

جمع بندی

در این مقاله آموزشی بطور عملی نحوه کار با دیتابیس mongodb در php را دیدم. همانطور که مشاهده کردید کار با این دیتابیس nosql بسیار ساده است و با نصب درایور آن در PHP به راحتی می توانید از آن در پروژه های تحت وب خود استفاده کنید.

توجه کنید که دیتابیس های NoSQL مثل MongoDB برای همه پروژه ها مناسب نیستند و بنابر ساختار داده های پروژه شما استفاده از آن یا استفاده از جایگزین دیگر مثلا دیتابیس های رابطه ای مانند MySQL می تواند مناسب باشد.

قبل از انتخاب دیتابیس mongoDB در پروژه های خود بهتر است که use case یا ساختار های مورد استفاده mongodb را به اینصورت جستجو کنید : use case for mongodb

یک نمونه از این use case را در سایت slideshare می توانید ببنید : https://www.slideshare.net/mongodb/common-use-cases-hannes

در کل برای پروژه های سنگین با پیش بینی وجود حجم بسیار زیادی از کاربران و اطلاعات دیگر می توانید از دیتابیس های NoSQL مانند MongoDB برای پروژه های تحت وب خود بهره ببرید.

بنابراین برای افزایش مقیاس پذیری پروژه خود و قابلیت توسعه پذیری نرم افزار تحت وب خود همیشه سعی کنید قبل از پیاده سازی آن استک (stack) نرم افزاری مناسب را انتخاب کنید که از این بین دیتابیس اهمیت بیشتری دارد.

برای اطلاعات بیشتر داکیومنت آنلاین mongoDB را مطالعه کنید

امیدوارم از بخش نهایی آموزش کار با دیتابیس mongodb در php نهایت استفاده را برده باشید.

برای دانلود سورس کد کامل مینی پروژه وبلاگ از باکس دانلود زیر استفاده کنید.

هر سوالی داشتید ، از قسمت نظرات ارسال کنید . سریعا ، پاسخگوی سوالات شما هستیم .

موفق و پیروز باشید.

لغو پاسخ

مسعود ۹ مرداد ۱۴۰۱

سلام سوالی داشتم اول اینکه ایا امکان استفاده از اطلس مانگو از ایران وجود داره یا نه؟
سوال دوم فرض کنید جدول اخبار رو داریم و از یوزرهای مختلف ارسال میشه تو مای اس کیو ال فیلدی اضافه میکنیم به نام مثال یوزر ایدی که مشخص بشه کی ارسال کرده…
حالا توی مانگو من اگه بیام بگه کالکشنی که ایجاد میکنی به نام news بیام ثبت کنم کالکشن نیوز و اخرش ایدی یوزر رو بدم و برای هر یوزر کالکشن جدید ساخته بشه.. اصلا این منطقی و کار درستی هست یا همون روش قبلی همه در یک کالکشن و فقط یوزر ایدی اضافه بشه!؟ برای این پرسیدم که موقع فراخانی هم کالکشن هر یوزر رو بصورت جدا داشته باشم. فقط از لحاظ منطقی بودن کارم میپرسم!؟

پاسخ

آموزش کار با دیتابیس mongodb در php – بخش دوم

نصب درایور PHP برای دیتابیس MongoDB

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

کار با دیتابیس mongodb در php

اتصال به دیتابیس MongoDB

انتخاب یک دیتابیس

عملیات CRUD دیتابیس MongoDB در PHP

ایجاد/انتخاب یک کالکشن (Collection)

ساخت یک سند (Document)

خواندن یک سند (Document)

بروزرسانی (Update) یک سند

مینی پروژه ساخت وبلاگ

فایل config.php

فایل app.php

فولدر admin

جمع بندی

دانـلود باکــس

آموزش کار با دیتابیس mongodb در php – بخش اول

لغو پاسخ

دوره آموزش ساخت دیجی کالا با php به همراه اپلیکیشن اندروید

آموزش ساخت ربات تلگرام با PHP (از پایه و پروژه محور)

دوره جامع آموزش طراحی سایت + پروژه قالب فروشگاه