advanced introduction to codeigniter

CodeIgniter 進階應用

Bo-Yi Wu 吳柏毅
2012.02.18
http://blog.wu-boy.com/

Outline
 如何善用使用 CodeIgniter 內建函式庫
 移植及撰寫個人 Library
 擴充核心程式碼
 GetSparks 簡介

如何善用 CodeIgniter 函式庫 ?
3

Loader Library
系統自動初始化

4

如何使用

$this->load->library('class', $config, 'object')

$this->load->library('email');

$this->email->some_function().

5

同時載入多個函式庫

$this->load->library(array('email', 'table'));

6

傳入參數

$this->load->library('class', $config)

example: $this->load->library('email')

$config = array (
'mailtype' => 'html',
'charset' => 'utf-8,
'priority' => '1'
);
7

Library 參數初始化

public function __construct($config = array())
{
if (count($config) > 0)
{
$this->initialize($config);
}
}

initialize 為 class 其中一個 function
8

指定物件名稱

$this->load->library('session', $config)
$this->session->some_function()

$this->load->library('session', $config, 'my_sess')
$this->my_sess->some_function()

9

Config Library
系統自動初始化

10

系統自動讀取網站設定檔
(application/config/config.php)

11

將固定資料都存放在 config 目錄

application/config/bitly.php

12

範例存放 API Key

<?php
$config['user_name'] = 'appleboy';
$config['api_key'] = 'xxxxxxxx';
$config['format'] = 'json';
?>

13

取得設定檔資料

$this->config->load('bitly');
$this->config->item('api_key');

14

在這裡大家有沒有一個疑問
假設載入兩個設定檔

15

<?php
$config['user_name'] = 'appleboy';
$config['api_key'] = 'api_key_01';
$config['format'] = 'json';
?>
application/config/tiny.php
<?php
$config['user_name'] = 'appleboy46';
$config['api_key'] = 'api_key_02';
$config['format'] = 'xml';
?> 16

$this->config->load('bitly');
$this->config->load('tiny');

17

輸出資料會是 ?

$this->config->item('api_key');

答案 : api_key_02

18

為什麼資料變數會衝突呢 ?
那該如何解決 ?

19

系統載入流程
 檢查 application/config/ 目錄檔案是否存在
 不存在 (continue)
 存在 (include 方式載入 )

後載入覆蓋前面設定檔

20

解決變數衝突

第二個參數設定為 true

$this->config->load('bitly', true);
$this->config->load('tiny', true);

21

衝突讀取方式

加入第三參數
$this->config->item('api_key', 'bitly');
$this->config->item('api_key', 'tiny');

22

另類解決方式

item key 為什麼會出現衝突 ?

23

Web 程式設計師
對變數命名方式大不同
( 資料庫欄位命名 )
user_name
UserName
username

24

改變 key 命名方式
prefix_name + item_name

25

<?php
$config['bitly_user_name'] = 'appleboy';
$config['bitly_api_key'] = 'api_key_01';
$config['bitly_format'] = 'json';
?>
application/config/tiny.php
<?php
$config['tiny_user_name'] = 'appleboy46';
$config['tiny_api_key'] = 'api_key_02';
$config['tiny_format'] = 'xml';
?> 26

此命名方式可以加速
其他程式設計師
閱讀程式碼方便性

27

作業一
 新增 template 設定檔
 base_title
 site_keyword
 site_description
 將設定檔內容讀出並載入到 layout

28

Email Library
大量寄信

29

Email Class
 多重收件人
 副本 (CC) 和密件副本 (BCCs)
 支援 HTML 或者是純文字 (Plaintext) 郵件
 附件檔案
 Email Debugging tools

30

$this->load->library('email');

$this->email->from('your@example.com', 'Your Name');
$this->email->to('someone@example.com');
$this->email->cc('another@another-example.com');
$this->email->bcc('them@their-example.com');

$this->email->subject('Email Test');
$this->email->message('Testing the email class.');

$this->email->send();

echo $this->email->print_debugger();

31

 $this>email>to()
 $this>email>cc()
 $this>email>bcc()
 可以帶入陣列或單一資料
 $this>email>send()

if ( ! $this->email->send())
{
echo $this->email->print_debugger();
}

32

附件檔案

$this->email->attach('file_path')

$this->email->attach('/path/to/file01.zip');

$this->email->send();

33

File Uploading Library
( 多檔案上傳 )
34

檔案上傳流程
 設定存放上傳目錄權限
 調整 php.ini 檔案上傳設定
 建立上傳表單
 驗證使用者上傳檔案
 印出檔案訊息並且寫到資料庫

35

$config['upload_path'] = './uploads/';
$config['allowed_types'] = 'gif|jpg|png';
$config['max_size'] = '100';
$config['max_width'] = '1024';
$config['max_height'] = '768';

$this->load->library('upload', $config);

if ( ! $this->upload->do_upload('input_column_name'))
{
$error = array('error' => $this->upload->display_errors());
$this->load->view('upload_form' ， $error);
}
else
{
$data = array('upload_data' => $this->upload->data());
$this->load->view('upload_success' ， $data); 36
}

設定參數
 upload_path( 絕對或者是相對即可 )
 allowed_types( 可上傳類型用豎線 '|' 分開 )
 overwrite( 相同檔名則覆蓋 )
 max_size( 檔案大小限制 )
 max_width( 圖片專用 )
 max_height( 圖片專用 )
 encrypt_name( 檔名加密字串取代 )

37

$this->upload->data()
[file_name] => mypic.jpg
[file_type] => image/jpeg
[file_path] => /path/to/your/upload/
[full_path] => /path/to/your/upload/jpg.jpg
[raw_name] => mypic
[orig_name] => mypic.jpg
[file_ext] => .jpg
[file_size] => 22.2
[is_image] => 1
[image_width] => 800
[image_height] => 600
[image_type] => jpeg
[image_size_str] => width="800" height="200"
38

作業二
 新增上傳表單
 將上傳檔案資訊存入資料庫
 並且將檔案以附件寄給該使用者

39

Form Validation Library
表單驗證
40

欄位驗證
1. 欄位包含非法字元
2. 欄位長度必須大於 minimum
3. 欄位長度必須小於 maximum
4. 使用者名稱不能重複 ( 資料庫比對 )

41

Controller
$this->load->library('form_validation');

if ($this->form_validation->run() == false)
{
$this->load->view('myform');
}
else
{
$this->load->view('formsuccess');
}
42

表單驗證規則

$this->form_validation->set_rules()

43

驗證規則 ( 註冊表單 )

$this->form_validation->set_rules('username', ' 帳號 ', 'required');
$this->form_validation->set_rules('password', ' 密碼 ', 'required');
$this->form_validation->set_rules('passconf', ' 確認 ', 'required');
$this->form_validation->set_rules('email', ' 電子郵件 ', 'required');

44

Form Controller

$this->form_validation->set_rules('username', ' 帳號 ', 'required');
$this->form_validation->set_rules('passconf', ' 確認密碼 ', 'required');

if ($this->form_validation->run() == FALSE)
{
}
else
{
}
45

多重驗證規則

$this->form_validation->set_rules('username', ' 帳號 ',
'required|min_length[5]|max_length[12]|
is_unique[users.username]');

$this->form_validation->set_rules('password', ' 密碼 ',
'required|matches[passconf]');

$this->form_validation->set_rules('passconf', ' 確認密碼 ',
'required');

$this->form_validation->set_rules('email', ' 電子郵件 ',
'required|valid_email|is_unique[users.email]');
46

記憶表單
欄位驗證失敗回到表單
顯示之前留下的資料
$this->load->helper('form')

set_value('username', 'appleboy')
set_select('myselect', 'one', true)
set_checkbox('mycheck[]', '1', true)
set_radio('myradio', '1', true)
48

自行設計驗證函數

$this->form_validation->set_rules
('username', ' 帳號 ', 'callback_username_check')

49

public function index()
{

$this->form_validation->set_rules('username', ' 帳號 ',
'callback_username_check');
$this->form_validation->set_rules('passconf', ' 確認密碼 ', 'required');

if ($this->form_validation->run() == FALSE)
{
}
else
{
}
} 50

Call back function

public function username_check($str)
{
if ($str == 'test')
{
return FALSE;
}
else
{
return TRUE;
}
}

51

定義錯誤訊息

$this->form_validation->set_message
('rule', 'error message')

52

錯誤訊息

全部顯示
<?php echo validation_errors(); ?>
個別顯示
<?php echo form_error('file_name'); ?>

53

作業三

使用者註冊表單

欄位 :Email, 密碼 , 確認密碼

撰寫 call back function 確認帳號是否存在

自訂錯誤訊息

54

Image Manipulation Library
( 影像處理 )
55

影像處理 (GD vs ImageMagic)
 修改尺寸
 建立縮圖
 圖片裁剪
 圖片旋轉
 浮水印

56

個人建議大量圖形網站用
ImageMagic
( 支援 command line 執行 )
( 獨立處理圖片 )
( 不需要動到前端 Server)

57

如果公司經費許可
AWS S3 雲端儲存服務
Simple Storage Service

58

初始化

$this->load->library('image_lib')

59

處理影像

$config['image_library'] = 'gd2';
$config['source_image'] = '/path/mypic.jpg';
$config['create_thumb'] = true;
$config['width'] = 75;
$config['height'] = 50;

$this->load->library('image_lib', $config);

$this->image_lib->resize();

60

參數設定
 image_library: GD, GD2, ImageMagick, NetPBM
 library_path: Linux, Windows 底下路徑
 source_image: 絕對 / 相對路徑
 new_image: 輸出檔案絕對 / 相對路徑
 width: 圖片寬度
 height: 圖片高度
 create_thumb: 避免覆蓋原檔案

61

錯誤訊息

if ( ! $this->image_lib->resize())
{
echo $this->image_lib->display_errors();
}

62

影像處理函數
 $this>image_lib>resize()
 $this>image_lib>crop()
 $this>image_lib>rotate()
 $this>image_lib>clear()

63

影像處理函數

64

務必設定
 $config['create_thumb'] = true;
 $config['new_image'] = '/path/new_image.jpg';

避免原始檔案被處理 ( 保留原檔 )

65

影像處理函數

66

$config['image_library'] = 'imagemagick';
$config['library_path'] = '/usr/local/bin';
$config['source_image'] = '/path/to/mypic.jpg';
$config['x_axis'] = '100';
$config['y_axis'] = '60';

$this->image_lib->initialize($config);

if ( ! $this->image_lib->crop())
{
}

67

影像處理函數

68

$config['image_library'] = 'netpbm';
$config['library_path'] = '/usr/bin/';
$config['source_image'] = '/path/to/mypic.jpg';
$config['rotation_angle'] = 'hor';

$this->image_lib->initialize($config);

if ( ! $this->image_lib->rotate())
{
}

69

rotation_angle 參數
 90( 順時針 90 度 )
 180( 順時針 180 度 )
 270( 順時針 270 度 )
 hor( 水平旋轉 )
 vrt( 垂直旋轉 )

70

影像處理函數

71

$this->image_lib->clear()
重置所有設定項目

72

作業
 增加使用者頭像上傳
 限制上傳檔案型態 (jpeg,jpg,png,gif)
 可以自訂圖像 ( 隨時更改 )
 製作縮圖顯示於使用者列表

73

Language Library
( 多國語系 )
74

兩個存放語系目錄
 application/language/[english|zhtw]
 system/language/[english|zhtw]
 先後讀取

application/config/config.php 設定預設語系

75

建立語言檔案
 檔案命名方式
 error_lang.php
 內容以 $lang 陣列方式表示
 $lang['language_key'] = " 我是中文 ";

76

$lang['error_email'] = " 您必須填入電子郵件 ";
$lang['error_url'] = " 您必須填入完整網址 ";
$lang['error_username'] = " 您必須填入帳號名稱 ";

避免衝突

77

讀取語言檔案

$this->lang->load('filename', 'language')

78

讀取資料

Language helper 函式

lang('language_key')

$this->load->helper('language');

79

作業
 請用下列 URL 切換中英文語系
 index.php/controller/function?lang=zhtw

80

Pagination Library
( 分頁處理 )
81

$this->load->library('pagination');

$config['base_url'] = '/index.php/test/page/';
$config['total_rows'] = 200;
$config['per_page'] = 20;

$this->pagination->initialize($config);

echo $this->pagination->create_links();

82

分頁參數
 base_url: 完整的 URL 路徑 , 包含了控制器
(controller)/ 函數 (function)
 total_rows: 總筆數
 per_page: 單頁顯示幾筆
 uri_segment: URI 哪個部份包含了頁數
 num_links: 您目前所在頁數前面跟後面所顯示的
分頁數量
 use_page_numbers: 用 page number 顯示
83

講了這麼多 CodeIgniter 內建 Library
那該如何撰寫屬於自己的套件呢

84

如果別人寫好的 Library
該如何無痛導入到
CodeIgniter

85

注意事項
 檔案命名
 一律採用小寫命名 , 如 my_class.php
 類別宣告
 類別宣告第一個字母必須為大寫 , 如 class
My_class

86

<?php if ( ! defined('BASEPATH')) exit('No direct
script access allowed');

class Someclass {

public function some_function()
{
}
}

/* End of file Someclass.php */

87

初始化類別傳遞參數

$params = array('type' => 'large', 'color' => 'red');

$this->load->library('someclass', $params);

88

public function __construct($config = array())
{
If ( ! empty($config))
{
$this->initialize($config);
}
}

89

在 Library 裡該如何使用
CodeIgniter 其他資源呢 ?

90

$this->load->helper('url');
$this->load->library('session');
$this->config->item('base_url');

91

$this->_obj =& get_instance();

92

public function __construct()
{
$this->_obj =& get_instance();
$this->_obj->load->config('google_url_api');
}

93

作業
 建立個人專用 Library
 將 goo.gl php library 導入
 http://code.google.com/p/googlphp/

94

網站一定會有共同處理的地方
( 多國語系 )
( 多重登入 Facebook,Google)

95

如果有 10 個 Controller
那不就 10 個檔案
都加上相同程式碼？

96

這時候就需要

擴充核心函式庫

97

class Welcome_01 extends CI_Controller

Controller 都需要有共同的變數及函數

98

class Welcome_01 extends MY_Controller

更改變數及函數則大家一起變動

99

CI_Controller

控制器 01 控制器 02 控制器 03 控制器 04 控制器 05

登入函式登入函式登入函式登入函式登入函式

100

CI_Controller

MY_Controller

登入模組

控制器 01 控制器 02 控制器 03 控制器 04 控制器 05

101

直接更換核心類別
 放置目錄 application/core/
 更換 input 核心
 application/core/input.php

class CI_Input {
public function __construct() {}
}

102

擴充核心類別
 類別宣告必須繼承父類別
 新類別名稱與檔名必須使用 MY_ 前置字串
 命名 : application/core/MY_Input.php

class MY_Input extends CI_Input {

function __construct()
{
parent::__construct();
}
} 103

自訂子類別的前置字串

編輯 application/config/config.php

$config['subclass_prefix'] = 'MY_';

104

作業
 練習擴充 CI_Controller 核心
 index.php/welcome/?lang=english
 index.php/welcome/?lang=zhtw
 擴充核心取得 $_GET['lang'] 變數資料
 利用此變數將 language 檔案載入實現多國語系

105

目標
 會員註冊系統
 Email 認証信
 Form 表單驗證
 多國語系
 會員資料編輯
 個人照片上傳
 會員登入

106

CodeIgniter 核心功能
不夠網站開發需求嘛 ?

107

歡迎使用
CodeIgniter getsparks

108

What is Sparks?

Ruby 有 RubyGems
Node.js 有 npm
CodeIgniter 有 sparks

109

What is Sparks?

Package Management System

Making Code Easy to
Find, Create, and Distribute

110

Get Sparks tool Now!!

一行指令就安裝完成
php -r "$(curl -fsSL http://getsparks.org/go-
sparks)"

111

Load Sparks Library

$this->load->spark(google-url-shortener/1.0.4');
$short_url = $this->google_url_api->shorten($url);
echo $url . " => " . $short_url->id . "<br />";

112

Installing getsparks library

http://goo.gl/lHmCX
$ php tools/spark install -v1.0.4 google-url-shortener

113

今天課程就到這裡
大家有任何問題嘛

114

謝謝大家
對於 CodeIgniter 有任何問題
可以到論壇留言
http://www.codeigniter.org.tw/forum/

115

advanced introduction to codeigniter

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (20)

Similar to advanced introduction to codeigniter

Similar to advanced introduction to codeigniter (20)

More from Bo-Yi Wu

More from Bo-Yi Wu (18)

advanced introduction to codeigniter