CRUD表單設計 Day-02 安裝PHP Framework

2019-08-16

Mars Hung

training

文章閱讀量次

一、說明

一個優秀的PHP框架，能幫助我們的程式編寫更合理，更便於維護，框架題供的工具函式，也可以大量簡化我們的開發步驟，而在團隊開發中，框架更提供一個共同的規範讓團隊依循。

在此使用框架 CodeIngiter 3

二、建立Git repository

前往GitHub註冊帳號
建立repository: crud-training
- 點選右上角頭像旁的＋號，再選「New repository」
- 填寫資料
取得 crud-training 的 Git Repo RUL
- 點選Clone or download
- 使用SSH URL並複製

Clone crud-training

# 刪除原本的crud-training資料夾
$ cd /var/www/html
$ sudo rm -rf crud-training
# Clone git repo 至 crud-training資料夾
$ git clone {Git Repo RUL} crud-training
# 回到crud-training
$ cd crud-training

將**{Git Repo RUL}**替換成剛剛複製的Git Repo RUL

註：如果Linux與Github間的金鑰認証沒有做好，會clone失敗，請參考帳號安全設定-GitHub

三、安裝 CodeIngiter 3

3.1 下載CodeIngiter 3

前往 CodeIngiter 3 官網，下載檔案

3.2 解壓縮並上傳至遠端開發目錄

下載並安裝WinSCP
連線至遠端目錄
上傳檔案

沒用的檔案可以不傳
查看上傳結果-從VSCode
查看上傳結果-從瀏覽器

前往網址：https://crud-training.dev.idv/

3.3 推送至Git

查看目前git log
1
$ git log
查看變動的檔案
1
$ git status
暫存”所有”變動檔案
1
$ git add .
再查看變動的檔案
1
$ git status

Commit 暫存檔案

1
2
3

$ git commit
# 在第一行輸入： [Upload] Upload CodeIgniter 3
# 儲存離開

用#開頭的行不會被git處理，是給使用者看的

推送至Git
1
$ git push
再查看目前git log
1
$ git log
去Github查看上傳結果

四、設定 CodeIngiter 3

4.1 建立Composer資料&目錄

在application目錄下建立檔案composer.json (按右鍵=>新增檔案)

填入composer.json檔案內容

{
    "name": "dev/codeigniter",
    "description": "Composer package list and local code autoload support.",
    "type": "project",
    "license": "MIT",
    "autoload": {
        "psr-4": {
            "app\\": "./"
        }
    },
    "require": {}
}

安裝composer相關資料
1
2
$ cd application
$ composer install
安裝完成後，application下會出現vendor目錄

4.2 修改composer設定值

開啟檔案 application/config/config.php
修改 $config[‘composer_autoload’] = TRUE; (FALSE => TRUE)

4.3 編輯.gitignore(忽略git處理清單)

application/cache/*
application/logs/*
composer.lock
/vendor/
application/vendor

4.4 上傳Git

# 查看變動
$ git status
# 暫存所有變動
$ git add .
# commit 變動檔案
$ git commit
# 推送
$ git push

五、目錄結構

|-- application 項目目錄
    |-- core 項目的核心程序
    |-- helpers 項目的輔助函數
    |-- libraries 通用類庫
    |-- language 語言包
    |-- config 項目相關的配置
        |-- config.php 項目相關的配置文件
        |-- database.php 數據庫相關的配置文件
        |-- autoload.php 設置自動加載類庫的配置文件
        |-- constants.php 常量配置文件
        |-- routes.php 路由配置文件
    |-- controllers 控制器目錄
        |-- welcome.php 控制器文件，繼承CI_Controller
    |-- models 模型目錄
        |-- welcome_model.php 模型文件，繼承CI_Model
    |-- views 視圖目錄
        |-- welcome.php 視圖模板文件，默認後綴名為.php
    |-- cache 存放數據或模板的緩存文件
    |-- errors 錯誤提示模板
    |-- hooks 鉤子，在不修改系統核心文件的基礎上擴展系統功能
    |-- third_party 第三方庫
    |-- logs 日誌

|-- system 框架程序目錄
    |-- core 框架的核心程序
        |-- CodeIgniter.php 引導性文件
        |-- Common.php 加載基類庫的公共函數
        |-- Controller.php 基控制器類文件：CI_Controller
        |-- Model.php 基模型類文件：CI_Model
        |-- Config.php 配置類文件：CI_Config
        |-- Input.php 輸入類文件：CI_Input
        |-- Output.php 輸出類文件：CI_Output
        |-- URL.php URL類文件：CI_URl
        |-- Router.php 路由類文件：CI_Router
        |-- Loader.php 加載類文件：CI_Loader
    |-- helpers 輔助函數
        |-- url_helper.php url相關的輔助函數，如：創建url的輔助函數
        |-- captcha_helper.php創建圖形驗證碼的輔助函數
    |-- libraries 通用類庫
        |-- Pagination.php 通用分頁類庫
        |-- Upload.php 通用文件上傳類庫
        |-- Image_lib.php 通用圖像處理類庫
        |-- Session.php 通用session類庫
    |-- language 語言包
    |-- database 數據庫操作相關的程序
        |-- DB_active_rec.php 快捷操作類文件(ActiveRecord)
    |-- fonts 字庫

|-- index.php 入口文件

system目錄下的資料不建議變動

六、第一支程式 Hello World!

6.1 建立Controller

建立檔案
application/controllers/Hello.php

寫入內容

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

class Hello extends CI_Controller {

    public function index()
    {
        $this->load->view('hello');
    }
}

Controller檔名第一個字母大寫，class名子和檔名一樣

Load view時，只需填寫view的檔名

6.2 建立View

建立檔案
application/views/hello.php

寫入內容

<?php
defined('BASEPATH') or exit('No direct script access allowed');
?>
<!DOCTYPE html>
<html lang="en">

<head>
	<meta charset="utf-8">
	<title>Hello World!</title>
</head>

<body>

	<div>
		<h1>Hello World!</h1>
		<p>This is some text.</p>
	</div>

</body>

</html>

View檔名小寫即可

6.3 查看結果

打開網址https://crud-training.dev.idv/hello

上面的hello，是controller名稱Hello字首轉小寫而來 (只有字首會轉小寫)

6.4 推送至Git

# 查看變動
$ git status
# 暫存所有變動
$ git add .
# commit 變動檔案
$ git commit
# 推送
$ git push

七、資料庫存取

本教學中選用MySQL資料庫

7.1 資料設計

使用者在網頁前端輸入的資料，傳送到後端處理完後，必需存到資料庫中，以待後續取用。但資料要如何存取才符合需求並有好的效率，資料庫設計至關重要。

7.1.1 建構原則

編碼使用 utf8_unicode_ci

如果資料欄位可能為中英夾雜，使用utf8_unicode_ci
如果可以確定欄位為純ASCII可用ascii_bin (進階)
使用小寫英文命名，單字用底線分隔

不使用大寫及其他符號
資料表名稱不宜太長，以 4 個字以下為原則

字元過多可用縮寫代稱
欄位名稱不宜太長，以4個字以下為原則

字元過多可用縮寫代稱
資料表及欄位需有備註(COMMENT)
每個資料表需有主鍵、索引鍵

建議擁有auto_increment型態的主鍵，以便使用where in精確查詢
資料表建議有資料識別欄位

建立日、建立者、更新日、更新者、軟刪日、軟刪者、資料狀態

7.1.2 常用格式

數字型態

格式名稱	位元數	備註
TINYINT[(M)]	1 byte	Signed: -128 to 127 (-2^7 to 2^7-1) Unsigned: 0 to 255 (0 to 2^8-1)
INT[(M)]	4 byte	Signed: -2^31 to 2^31-1 Unsigned: 0 to 2^32-1
BIGINT[(M)]	8 byte	Signed: -2^63 to 2^63-1 Unsigned: 0 to 2^64-1
DECIMAL[(M[,D])]	M+2 byte	M是數字的最大數(精度) D是小數點右側數字的數目(標度) decimal(5,2) 為 xxx.xx

上表中的 M 代表「最大顯示寬度」

字串型態

格式名稱	位元數	備註
VARCHAR(M)	L+1 bytes	最大長度 M bytes
TEXT	L+2 bytes	最大長度 2^16-1 bytes
MEDIUMTEXT	L+3 bytes	最大長度 2^24-1 bytes
LONGTEXT	L+4 bytes	最大長度 2^32-1 bytes

上表中的 L 代表「實際儲存的空間大小」

時間型態

格式名稱	位元數	備註
DATE	3 bytes	‘0000-01-01’ to ‘9999-12-31’
TIME	3 bytes	‘-838:59:59’ to ‘838:59:59’
DATETIME	8 bytes	1000-01-01 00:00:00 to 9999-12-31 23:59:59
TIMESTAMP	4 bytes	自 1970 年起，至 2037 年的某時

列舉型態

格式名稱	位元數	備註
ENUM	1~2 bytes	65535 個成員，單選
SET	1~8 bytes	64 個成員，可以多選

7.1.3 需求假設

有一部門管理介面，需要可填寫部門代碼、部門名稱、部門層級、開始時間、結束時間、備註，其中部門代碼維一

欄位整理：

主鍵欄位	資料欄位	管理欄位
系統序號	代碼	建立日
	名稱	建立者
	層級	更新日
	開始日	更新者
	結束日	軟刪日
	備註	軟刪者
		資料狀態

管理欄位視狀況選用

7.1.4 需求設計

資料表 : dept_info 單位資料
欄位

欄位名稱	型態	長度	備註	說明	A_I
d_id	int	10	系統序號	SQL主鍵	V
d_code	varchar	15	代碼
d_name	varchar	60	名稱
d_level	varchar	15	層級
date_start	date		開始日	預設 0000-00-00
date_end	date		結束日	預設 9999-12-31
remark	text		備註
date_create	datetime		建立日
user_create	int	10	建立者
date_update	datetime		更新日
user_update	int	10	更新者
date_delete	datetime		軟刪日
user_delete	int	10	軟刪者
rec_status	tinyint	1	資料狀態	無效(0) 有效(1)

索引
- 主鍵 : d_id
- 索引 : d_code

建構語法

CREATE TABLE `dept_info` (
  `d_id` int(10) UNSIGNED AUTO_INCREMENT NOT NULL COMMENT '系統序號',
  `d_code` varchar(15) NOT NULL COMMENT '代碼',
  `d_name` varchar(60) NOT NULL COMMENT '名稱',
  `d_level` varchar(15) NOT NULL COMMENT '層級',
  `date_start` date NOT NULL COMMENT '開始日',
  `date_end` date NOT NULL DEFAULT '9999-12-31' COMMENT '結束日',
  `remark` text NOT NULL COMMENT '備註',
  `date_create` datetime NOT NULL COMMENT '建立日',
  `user_create` int(10) NOT NULL COMMENT '建立者',
  `date_update` datetime NOT NULL COMMENT '更新日',
  `user_update` int(10) NOT NULL COMMENT '更新者',
  `date_delete` datetime NOT NULL COMMENT '軟刪日',
  `user_delete` int(10) NOT NULL COMMENT '軟刪者',
  `rec_status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '資料狀態	無效(0) 有效(1)',
  PRIMARY KEY (`d_id`),
  KEY `d_code` (`d_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='單位資料';

在本表中除主鍵d_id外，另增加一組索引d_code

索引建立原則為

主鍵/外鍵必須有索引

查詢常用條件

識別性夠高

資料表間聯合查詢常用

長度小的欄位，如TEXT就不適合

頻繁進行資料操作的表，不要建立太多的索引

7.2 資料庫建構

7.2.1 phpmyadmin管理

登入管理介面

XAMPP版：http://localhost/phpmyadmin/
LANP版：https://sql.dev.idv/

7.2.2 建立資料庫