תחי ישראל - אין לנו ארץ אחרת

תחי ישראל -אין לנו ארץ אחרת

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

מחבר:
בתאריך:

Packagist and Composer

 

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

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

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

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

 

eBook cover The essentials of Object Oriented PHP

 

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

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

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

ראה: getcomposer

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

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

$ composer

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

composer command display

התקנת תלויות

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

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

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

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

packagist main page

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

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

faker package in packagist

אותנו מעניינת במיוחד השורה של ה-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:

eBook cover The essentials of Object Oriented PHP

 

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

 

 

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

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

 

 

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

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

שימו לב! הסקריפטים במדריכים מיועדים למטרות לימוד בלבד. כשאתם עובדים על הפרויקטים שלכם אתם צריכים להשתמש בספריות וסביבות פיתוח מוכחות, מהירות ובטוחות.

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

השימוש שלך באתר מהווה ראייה להסכמתך עם הכללים והתקנות שנוסחו בהסכם תנאי השימוש.

הוסף תגובה חדשה

 

 

ענה על השאלה הפשוטה הבאה כתנאי להוספת תגובה:

דג למים הוא כמו ציפור ל...?

 

תמונת המגיב

אלי בתאריך: 28.01.2018


ראשית כל תודה על המדריכים הטובים שלך שעוזרים לי הרבה!

רציתי לשאול האם תוכל לכוון אותי, למקום שאוכל
ללמוד על laravel( כולל איך מתקינים וכו). תודה רבה

תמונת המגיב

יוסי בן הרוש בתאריך: 28.01.2018

הי אלי
קודם כל צריך לדעת תכנות מונחה עצמים ב-PHP,
ורק אח"כ כדאי ללמוד framework דוגמת laravel.
הדוקומנטציה שלהם מצוינת
ויוטיוב מפוצץ בסרטונים.