Packagist ו-Composer לשילוב ספריות קוד קיימות בפרויקטים שלך

Packagist and Composer

האם נמאס לך להמציא מחדש את הקוד בכל פרויקט שאתה עובד במסגרתו? האם אתה רוצה לדעת היכן קהילת ה-PHP מחזיקה את כל ספריות הקוד שנכתבות במסגרת הפרוייקטים המובילים בעולם? האם תהית מהיכן אפשר לקבל קוד מוכן לניהול משתמשים או לטיפול בעגלת הקניות? האם מתאים לך לכתוב פחות קוד ובכל זאת להספיק הרבה יותר?

אם ענית בחיוב לפחות לאחת השאלות ואתה מתכנת PHP, כדאי שתכיר את השילוב המנצח שימנע ממך להמציא את הגלגל בכל פעם מחדש בגלל שהוא מאפשר לך לקחת ספריות קוד ממקורות שונים ולשלב אותם בפרויקטים שלך. השילוב שיעזור לך בכך, הוא בעצם צמד מנצח, והוא מורכב משילוב של composer עם packagist, שעושים בגדול שני דברים:

• packagist הוא מאגר גדול מאוד של ספריות קוד הכתובות ב-PHP
• composer מאפשר לך להוריד את ספריות הקוד מ-packagist אל הפרויקט שלך.

ומה שיפה הוא שהספריות שאתה מעוניין בהם יורדות ביחד עם כל התלויות שלהם (= כל ספריות הקוד שדרושות לפעולתם התקינה).

כיצד להתקין composer?

התקנת composer על לינוקס קלה מאין כמותה ונעשית באמצעות שורת הפקודות:

$ curl -s https://getcomposer.org/installer | php

ראה: getcomposer

התקנת composer על מערכת חלונות גם היא אינה קשה במיוחד ונעשית באמצעות אשף ייעודי (ראה הקישור למעלה).

נבדוק שההתקנה הצליחה על ידי הקלדת הפקודה הבאה לשורת הפקודות:

$ composer

ואם הצלחנו בהתקנה, נראה את הפקודות של composer לצד תיאור קצר שלהם:

התקנת תלויות

עלינו ליידע את composer על החבילות שאנו מעוניינים לייבא לפרויקט שלנו בקובץ composer.json שאותו נשים בתיקיית השורש של האתר (נחזור אליו בהמשך).

נחפש את החבילות במאגר packagist בכתובת: packagist.org

כשנגיע לדף שבקישור, נראה תיבת חיפוש, ולתוכה נקליד את השם של החבילה המבוקשת. לדוגמה, החבילה faker שיוצרת מידע דמה (שניתן להשתמש בו כממלא מקום בזמן פיתוח האתר).

מיד יעלו החבילות הרלוונטיות, ומתוכן נבחר בלחיצה את החבילה שבה אנו מעוניינים.

לחיצה על החבילה תפתח חלון ובו מספר ענפים של אותה החבילה. כדאי לנו לבחור את הענף הכי חדיש שאינו בפיתוח (אינו dev).

לחיצה על הענף המבוקש תפתח בפנינו חלון עם כל המידע אודות הענף.

אותנו מעניינת במיוחד השורה של ה-require, לדוגמה:

"fzaninotto/faker": "1.4.0"

נכתוב את התלויות לתוך קובץ ה-composer.json, אותו הוספנו מבעוד מועד לתיקיית השורש של האתר. לדוגמה:

{
  "require": {
    "fzaninotto/faker": "1.4.0"
  }
}

נתקין את החבילה באמצעות הפקודה:

$ composer install

מה שיגרום לכל החבילות לרדת באופן אוטומטי מהמקום שבו הם נמצאות באינטרנט אל תיקיית האתר שלנו.

בסוף התהליך, כשנלך לתיקיית השורש, נגלה שהתווספה תיקיית vendor שמחזיקה בתוכה את כל החבילות שהורדנו זה עתה.

בתיקיית vendor נמצא את הקובץ autoload.php שאחראי על טעינה אוטומטית של החבילות שהורדנו, ולכן צריך לדרוש אותו מכל קובץ php.

כדי להתחיל להשתמש בחבילות צריך לדרוש בראש כל קובץ php את קובץ ה-autoload:

require 'vendor/autoload.php';

על מנת לשפעל את הטעינה האוטומטית, נקליד בקונסולה את הפקודה הבאה:

$ composer dumpautoload

נכתוב בקובץ ה-index.php קוד שישמש לבדיקה שהחבילה שהורדנו אכן עובדת:

<?php
 
require_once __DIR__ . '/vendor/autoload.php';
 
// use the factory to create a FakerGenerator instance
$faker = FakerFactory::create();
 
// generate data by accessing properties
echo $faker->name;
 
// generate fake address
echo $faker->address;
 
// generate fake name
echo $faker->text;

עדכון החבילות שהורדנו באמצעות composer

ייתכן שבמשך הזמן נצטרך לעדכן את החבילות שהורדנו, וגם בזה מטפל composer ביעילות האופיינית. כל מה שצריך כדי לעדכן את כל החבילות בפרוייקט הוא לכתוב את הפקודה הבאה בקונסולה:

$ composer update

מה שיוריד אוטומטית לפרויקט שלנו את כל החבילות החדישות ביותר ביחד עם כל התלויות.

לסיכום

אני בטוח שהשילוב של packagist כמאגר של ספריות PHP ושל composer כמנהל חבילות יכול לסייע רבות לכל פרויקט PHP, כפי שהוא עושה בנאמנות רבה מזה מספר שנים.

מדריך טעינה אוטומטית של קבצים באמצעות composer autoload

המדריך מבוסס על "The essentials of Object Oriented PHP" שמלמד PHP מונחה עצמים באמצעות דוגמאות ותרגילים הקליקו על התמונה כדי לרכוש את ה-eBook:

לכל מדריכי ה-PHP מונחה עצמים

אהבתם? לא אהבתם? דרגו!

0 הצבעות, ממוצע 0 מתוך 5 כוכבים