دسته بندی Composer (نصب کتابخانه ها برای یک پروژه)، در PHP

ساخت یک پروژه PHP جدید با Composer و نصب یک کتابخانه برای آن، در PHP

نصب Composer :

اگر Composer را قبلا نصب نکرده اید، ابتدا آن را نصب کنید :

نصب Composer ، در PHP

ساخت یک پروژه PHP جدید با Composer :

فرض کنید می خواهیم یک پروژه PHP جدید در پوشه ای به مسیر زیر بسازیم و سپس یک کتابخانه دلخواه را برای آن نصب کنیم (با استفاده از Composer) :

ابتدا در خط فرمان ویندوز، دستور زیر را اجرا می کنیم تا پوشه MyProject ساخته شود (اگر پوشه kelidestan.com وجود نداشته باشد، آن را هم می سازد) :

ساخت یک پروژه PHP جدید با Composer و نصب یک کتابخانه برای آن، در PHP

سپس مسیر پوشه فعلی را به مسیر پوشه MyProject تغییر می دهیم :

دو حالت برای استفاده از Composer در یک پروژه PHP :

نکته مهم

پس از اینکه در خط فرمان ویندوز، مسیر پوشه فعلی را به مسیر پوشه پروژه (در اینجا پوشه MyProject) تغییر دادیم، باید به این نکته مهم دقت کنیم که برای استفاده از Composer در یک پروژه PHP ، دو حالت داریم :

1- هیچ فایل و کدی از قبل برای پروژه نساخته ایم (فایل composer.json وجود ندارد)

2- تعدادی فایل و کد از قبل برای پروژه داریم (فایل composer.json وجود دارد)

1- در حالت اول که هیچ فایل و کدی از قبل برای پروژه نساخته ایم، دستور زیر را در خط فرمان ویندوز اجرا می کنیم :

این دستور برای شروع یک پروژه و ساخت فایل composer.json به کار می رود. فایل composer.json در ریشه پروژه ایجاد می شود، اما هیچ وابستگی ای دانلود یا نصب نمی شود (برای نصب وابستگی ها، باید بعد از آن از دستور composer install استفاده شود).

2- در حالت دوم که تعدادی فایل و کد از قبل برای پروژه داریم، ابتدا فایل ها را در پوشه پروژه (در اینجا پوشه MyProject) کپی می کنیم و سپس دستور زیر را در خط فرمان ویندوز اجرا می کنیم :

این دستور برای نصب وابستگی های تعریف شده در فایل composer.json به کار می رود (تمام وابستگی های مورد نیاز، دانلود و نصب می شوند).

بنابراین چون ما فایل و کدی از قبل برای پروژه PHP آماده نکرده ایم، دستور زیر را اجرا می کنیم :

با اجرای دستور، Composer مواردی را در مورد مشخصات پروژه PHP که باید ساخته شود می پرسد و پس از پاسخ به همه آنها، پروژه PHP ساخته می شود :

بنابراین ساختار پروژه PHP به صورت زیر می باشد :

کدهای فایل composer.json عبارتند از (مطابق با مشخصاتی که ما در جواب پرسش ها گفته ایم) :

نصب یک پکیج برای پروژه PHP (مثل پکیج Monolog برای لاگ گیری) :

اکنون فرض کنید با استفاده از Composer می خواهیم پکیج Monolog را برای این پروژه PHP نصب کنیم. برای این منظور، دستور زیر را در خط فرمان ویندوز اجرا می کنیم :

با اجرای دستور بالا، موارد زیر توسط Composer انجام می شود :

پکیج را از Packagist دانلود می کند (از https://packagist.org/ ).

وابستگی های آن را هم نصب می کند.

فایل composer.json را به روز می کند.

فایل composer.lock را ایجاد می کند (نسخه دقیق پکیج ها را قفل می کند).

پکیج را در پوشه vendor/ نصب می کند.

بنابراین ساختار جدید پروژه به صورت زیر خواهد بود :

کدهای جدید فایل composer.json :

مشاده می کنید که عبارت زیر به بخش require آن اضافه شده :

نکته

همان طور که قبلا گفتیم، Composer برای نصب پکیج Monolog ، وابستگی های آن را هم نصب می کند. در مسیر فایل های پکیج Monolog در پروژه، یک فایل composer.json وجود دارد :

این فایل composer.json مربوط به پکیج Monolog است و اگر آن را باز کنیم، شامل کدهای زیر است :

{
    "name": "monolog/monolog",
    "description": "Sends your logs to files, sockets, inboxes, databases and various web services",
    "keywords": ["log", "logging", "psr-3"],
    "homepage": "http://github.com/Seldaek/monolog",
    "type": "library",
    "license": "MIT",
    "authors": [
        {
            "name": "Jordi Boggiano",
            "email": "j.boggiano@seld.be",
            "homepage": "http://seld.be"
        }
    ],
    "require": {
        "php": ">=5.3.0",
        "psr/log": "~1.0"
    },
    "require-dev": {
        "phpunit/phpunit": "~4.5",
        "graylog2/gelf-php": "~1.0",
        "sentry/sentry": "^0.13",
        "ruflin/elastica": ">=0.90 <3.0",
        "doctrine/couchdb": "~1.0@dev",
        "aws/aws-sdk-php": "^2.4.9 || ^3.0",
        "php-amqplib/php-amqplib": "~2.4",
        "swiftmailer/swiftmailer": "^5.3|^6.0",
        "php-console/php-console": "^3.1.3",
        "phpstan/phpstan": "^0.12.59"
    },
    "suggest": {
        "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server",
        "sentry/sentry": "Allow sending log messages to a Sentry server",
        "doctrine/couchdb": "Allow sending log messages to a CouchDB server",
        "ruflin/elastica": "Allow sending log messages to an Elastic Search server",
        "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib",
        "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)",
        "ext-mongo": "Allow sending log messages to a MongoDB server",
        "mongodb/mongodb": "Allow sending log messages to a MongoDB server via PHP Driver",
        "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB",
        "rollbar/rollbar": "Allow sending log messages to Rollbar",
        "php-console/php-console": "Allow sending log messages to Google Chrome"
    },
    "autoload": {
        "psr-4": {"Monolog\": "src/Monolog"}
    },
    "autoload-dev": {
        "psr-4": {"Monolog\": "tests/Monolog"}
    },
    "provide": {
        "psr/log-implementation": "1.0.0"
    },
    "scripts": {
        "test": "vendor/bin/phpunit",
        "phpstan": "vendor/bin/phpstan analyse"
    },
    "config": {
        "lock": false
    }
}

که بخش وابستگی های آن به صورت زیر مشخص شده :

پس برای اجرای پکیج Monolog ، باید php نسخه 5.3.0 یا بالاتر و همچنین psr/log به عنوان وابستگی های آن نصب شده باشند. بنابراین Composer مورد psr/log را هم برای پروژه نصب کرده که محل فایل های آن در مسیر زیر از پروژه می باشد :

اجرای پروژه PHP :

برای اجرای پروژه PHP ، ابتدا یک پوشه با نام public می سازیم (نام public یک نام مرسوم برای این مورد است، مثلا Laravel و Symfony و پروژه های مدرن هم از این نام استفاده می کنند) و درون آن، یک فایل ورودی پروژه (فایل اصلی پروژه) با نام index.php می سازیم (البته در مسیرهای دیگر هم می تواند قرار گیرد و به نوع پروژه و انتخاب شما بستگی دارد) :

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

به عنوان مثال، کد زیر را می نویسیم :

برای اجرای فایل index.php ، دو روش را در ادامه شرح می دهیم :

روش اول : استفاده از نرم افزار شبیه ساز سرور (مثل نرم افزار WampServer) :

کل پوشه پروژه را در پوشه اصلی مربوط به نرم افزار شبیه ساز سرور (مثل نرم افزار WampServer) قرار می دهیم (پوشه ای که نرم افزار شبیه ساز سرور برای اجرای PHP به کار می برد). بنابراین در پروژه ما، برای اجرای فایل index.php ، باید در مرورگر اینترنت، آدرس زیر را اجرا نماییم :

بنابراین در خروجی مرورگر اینترنت، عبارت ((پایان)) نمایش داده می شود :

و همچنین در کنار فایل index.php ، یک فایل با نام app.log ساخته می شود که در آن، لاگ ها (Log) نوشته شده اند (ساخت این فایل و لاگ نویسی (Log)، توسط پکیج Monolog انجام شده) :

روش دوم : استفاده از سرور داخلی PHP

در خط فرمان ویندوز، وارد ریشه پروژه (یعنی هم سطح با پوشه public/ ) می شویم (یعنی مسیر پوشه فعلی خط فرمان را برابر پوشه MyProject قرار می دهیم) و دستور زیر را در خط فرمان ویندوز اجرا می کنیم :

با اجرای دستور بالا، فایل های درون پوشه public ، بر روی ((سرور روی پورت ۸۰۰۰)) اجرا می شوند. یعنی در مرورگر اینترنت در آدرس http://localhost:8000 می توانیم آنها را اجرا کنیم (بر اساس موقعیت قرارگیری آنها در پوشه public).

بنابراین برای اجرای فایل index.php از پروژه، آدرس زیر را در مرورگر اینترنت اجرا می کنیم :

بنابراین در خروجی مرورگر اینترنت، عبارت ((پایان)) نمایش داده می شود :

دسته بندی Composer (نصب کتابخانه ها برای یک پروژه)، در PHP

نویسنده علیرضا گلمکانی

شماره کلید 14482

گزینه ها

به اشتراک گذاری (Share) در شبکه های اجتماعی

FaceBook Twitter Digg Reddit LinkedIn Pinterest StumbleUpon

نظرات 0 0 0

ارسال نظر جدید (بدون نیاز به عضو بودن در وب سایت)