UEditor PHP使用說明

PHP 使用說明

文檔說明

支持版本：支持 UEditor 1.4.2+ 的版本

UEditor 除了靜態的編輯功能，還帶有不少和後端交互的功能，這個須要後臺語言支持。這裏介紹 PHP 後臺的 ueditor 使用方法以及注意的問題。

當前文檔的例子是以 圖片上傳 爲例介紹，其餘上傳配置方法相似。

1 部署服務器

1.1 安裝服務器

首先須要有一個安裝好的 PHP 服務器，如今流行的 PHP 服務器安裝方法有不少，能夠自行搜索對應操做系統的安裝教程。window 下可下載集成 apache + php 等多種服務的軟件：xampp 和 wamp，linux下能夠選擇 lamp 等軟件。

1.2 配置服務器

配置好服務器以後，須要修改 php 的配置文件 php.ini:

• 找到 post_max_size 改爲你但願 post 表單數據的最大容許值（包括上傳大小）
• 找到 upload_max_filesize 改爲你但願上傳文件最大容許值

1.3 檢查上傳目錄是否有權限讀寫

上傳目錄經過配置 imagePathFormat 格式的參數指定，配置位置在 php/config.json 裏。詳細用法看 上傳路徑配置

window 通常狀況都會有權限讀寫，在 linux 和 mac 系統下，須要注意運行 php 的用戶，有沒有權限讀寫上傳目錄。

IIS 服務器掛接 PHP 的狀況下，注意上傳目錄不在程序目錄下時，要設置 "啓用父路徑" 爲true，才能正常訪問父目錄。

1.3. 運行測試

配置好服務器以後，能夠測試一下 php 代碼是否正確執行，在瀏覽器打開 ueditor/controller.php 對應的路徑，看看是否有下面的返回值。

{ state: "請求地址出錯" }

再訪問 ueditor/php/controller.php?action=config 是否正常返回了json格式的後端配置內容，格式大體以下。

{ "imageUrl": "http://localhost/ueditor/php/controller.php?action=uploadimage", "imagePath": "/ueditor/php/", "imageFieldName": "upfile", "imageMaxSize": 2048, "imageAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"] "其餘配置項...": "其餘配置值..." }

若是以上這兩個請求出錯，出現400、500等錯誤，編輯器上傳相關的功能將不能正常使用。

2 配置說明

UEditor 的配置項分爲 前端配置項 和 後端配置項。

1.2 前端配置項

前端配置項只須要配置 serverUrl 參數，ueditor 1.4.2+ 起，推薦使用統一的請求路徑，在你部署好前端代碼後，你須要修改 ueditor.config.js 裏的 serverUrl 參數，改爲 URL + 'php/controller.php'

1.3 後端配置項

後端配置項在 php/config.json 裏配置，不一樣的上傳有各自的配置項。

具體看 後端配置說明 和 後端部署說明

3 錯誤信息

新版 UEditor 的全部請求都是向 controller.php 發起，再經過它分發到其餘 php 腳本執行，全部返回值都是有固定格式。後端請求規範

假如請求成功，返回的 json 內容裏的 state 屬性值爲 「SUCCESS」。 假如請求失敗，state 屬性值爲錯誤提示信息。

這裏介紹部分錯誤信息說明和常見問題。

• 文件大小超出 upload_max_filesize 上傳文件查出了大小限制，須要修改 imageMaxSize 格式的參數，另外php.ini裏面也有對應的上傳大小控制 post_max_size 和 upload_max_filesize
• 找不到臨時文件 上傳文件通常都是先保存到臨時目錄，再給php腳本處理，假如出現這樣的狀況：上傳文件超出了php.ini post_max_size 或 upload_max_filesize 就會致使php程序找不到臨時文件。
• 文件類型不容許 上傳的後綴名不容許，須要修改 imageAllowFiles 格式的參數。
• 目錄建立失敗、目錄沒有寫權限、寫入文件內容錯誤 須要檢查指定的上傳目錄是否有讀寫權限。