FuelPHP - Gói

Các gói tương tự như các mô-đun trong việc sử dụng lại mã nhưng khác ở những cách sau,

Nó không ánh xạ tới các URL web
Nó không thể tiếp cận được thông qua yêu cầu HMVC

Tóm lại, các gói không phải là các chức năng web trực tiếp như blog, album, v.v. Thay vào đó, nó là một thư viện các chức năng được nhóm lại với nhau như xử lý email, tạo tài liệu, tạo biểu đồ, xác thực, v.v. giúp phát triển web nhanh hơn. ứng dụng.

Tạo gói

Để tạo một gói, trước tiên chúng ta cần sắp xếp mã nguồn được chỉ định như sau.

/fuel 
   /packages 
      /package (root directory of package) 
         /bootstrap.php 
      /classes 
         /our.php 
      /classes.php 
         /here.php 
      /config 
         /config.php 
         /and_so_on

Cấu trúc của gói có hai tệp cụ thể của gói, tệp config.php và bootstrap.php. Mục đích của tệp cấu hình là nhóm cấu hình của gói trong chính thư mục gói mà không làm ảnh hưởng đến ứng dụng chính. Mục đích của tệp bootstrap là thiết lập không gian tên để trình tải tự động tải nó đúng cách.

Một số cách để đặt không gian tên như sau,

Autoloader::add_namespace('Mypackage', __DIR__.'/classes/'); 
Autoloader::add_core_namespace('Mypackage'); 
Autoloader::add_core_namespace('Mypackage', true); 
Autoloader::add_classes (array( 
   'Mypackage\\Classname' => __DIR__.'/classes/classname.php', 
   'Mypackage\\Anotherclass' => __DIR__.'/classes/anotherclass.php', 
));

Khi tệp bootstrap được định cấu hình đúng cách và các gói được tải vào ứng dụng, chúng ta có thể sử dụng nó như sau.

$instance = new Myclass; 
$instance = new Mynamespace\Myclass;

Cài đặt các gói

Các gói thường được đặt trong thư mục Nhiên liệu / gói. Theo mặc định, các gói sau được cài đặt,

auth - Gói xác thực
email - Gói email
oil - Lệnh nhiên liệu, gói dầu
orm - Gói ORM
parser - Gói phân tích cú pháp Markdown

Để cài đặt một gói mới, sau đây là hai tùy chọn,

Option 1 - Cài đặt thủ công - tải xuống và cài đặt

Để cài đặt gói theo cách thủ công, trước tiên hãy tải xuống gói từ trang web của tác giả. Giải nén nó và đặt nó dướifuel/packages/ thư mục.

Option 2 - Phương pháp tự động sử dụng lệnh dầu

FuelPHP cung cấp một cách tự động để cài đặt các gói được lưu trữ trong github. Sử dụng lệnh sau để cài đặt gói, mytestpackage.

php oil package install mytestpackage

Nó sao chép mã nguồn của gói bằng cách sử dụng ứng dụng git và di chuyển nó vào thư mục Nhiên liệu / gói. Nếu không có ứng dụng khách git, chúng ta có thể sử dụng đối số lệnh –direct để hướng lệnh tải xuống và cài đặt các gói như sau.

php oil package install mytestpackage --direct

Sử dụng các gói

Các gói có thể được sử dụng trong ứng dụng sau khi nó được tải vào ứng dụng. Có hai cách để tải các gói vào ứng dụng.

Option 1 - Thông qua lớp Gói

FuelPHP cung cấp một lớp học, Package để tải, dỡ tải và kiểm tra tính khả dụng của các gói thông qua các phương pháp tải, dỡ và tải, tương ứng. loadphương thức có hai tham số. Tham số đầu tiên,$package là tên của gói và tham số thứ hai, pathlà đường dẫn của gói. Tham số thứ hai là tùy chọn, nếu gói được cài đặt trongfuel/packages thư mục.

// load the orm package 
Package::load('orm');  

// load the parser package from a specific directory 
Package::load('parser', '/path/to/packages/dir/');  

// load the non-existent package 
Package::load('awesome'); // Throws a PackageNotFoundException

Option 2 - Thông qua tệp cấu hình

Để tải một gói vĩnh viễn, chỉ cần thêm gói dưới always_load mục cấu hình trong tệp cấu hình chính, fuel/app/config/config.php. Để nạp gói email, sử dụng cú pháp sau.

'always_load' => array ( 
   'packages' => array ( 
      'email', 
   ), 
),

Sau khi các gói được tải vào ứng dụng, chúng ta có thể sử dụng nó như sau.

$instance = new Myclass; 
$instance = new Mynamespace\Myclass;