安装PHP第三方库和UEditor

主要目标是安装PHP第三方库和UEditor。

推荐方式

Docker方式

• 安装Docker

  • Get Docker (opens new window)

• Docker帮助文档

  • 说明

• 安装PHP第三方库

  如果开发者熟悉Docker，可使用Docker安装PHP第三方库，就无需在本地安装composer了。

  在Docker容器内安装好UEditor，用修改过的UEditor备份文件(已先复制到容器内)覆盖，再将其复制到本地指定的文件路径下。

  以下操作均在根路径下命令行中执行:

  • 安装目录: 根路径
  • 创建镜像
    • docker build -t bb/composer --target=composer -f install/docker/Dockerfile .
  • 运行容器应用
    • docker run -dit --name=betterlife_composer bb/composer
  • 复制容器文件到本地:
    • 复制安装好的PHP第三方库文件到本地: docker cp betterlife_composer:/app/vendor/ $(pwd)/install/

• 安装UEditor

  如果开发者熟悉Docker, 可使用Docker在容器内安装好UEditor, 用修改过的UEditor备份文件(已先复制到容器内)覆盖，再将其从容器里复制到宿主机本地指定路径下。

  以下操作均在根路径下命令行中执行:

  • 安装目录: 根路径
  • 创建镜像
    • docker build -t bb/ueditor --target=ueditor -f install/docker/Dockerfile .
  • 运行容器应用
    • docker run -dit --name=betterlife_ueditor bb/ueditor
  • 复制容器文件到本地:
    • 复制安装好的UEditor包文件到本地: docker cp betterlife_ueditor:/app/misc/js/onlineditor/ueditor/ $(pwd)/misc/js/onlineditor/

本地方式

安装PHP第三方库

• 安装 composer

  • 安装composer: http://docs.phpcomposer.com/00-intro.html
    • 升级composer: composer self-update
    • 升级后回滚老版本: composer self-update --rollback
    • 阿里云 Composer 全量镜像 (opens new window)

• 安装目录下运行

  • 根路径下运行composer

    > composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
    > composer install --ignore-platform-reqs --no-interaction --no-plugins --no-scripts --prefer-dist
    

安装UEditor

必备条件

• 安装NodeJs

  下载地址: https://nodejs.org/en/download/

第一种方式

• 使用Git、Node工具。

• UEditor源码需用到Github库

  • Github国内镜像网站 (opens new window)
  • Github源库: https://github.com/fex-team/ueditor.git
  • 镜像一 : https://github.com.cnpmjs.org/fex-team/ueditor.git
  • 镜像二 : https://hub.fastgit.org/fex-team/ueditor.git

• 安装目录: 以下安装都在根路径/install 目录下

• 命令行下运行:

  > git clone https://github.com.cnpmjs.org/fex-team/ueditor.git -b dev-1.4.3.3
  > npm config set registry https://registry.npm.taobao.org 
  > cd ueditor && npm install && npm install -g grunt && npm install -g grunt-cli && grunt default \
  > cd ../../misc/js/onlineditor && mkdir ueditor \
  > cp -rf ../../../install/ueditor/dist/utf8-php/* ueditor/ \
  > cp -rf ueditor_bak/* ueditor/
  > cd ../../../install/ && rm -rf ueditor
  

第二种方式

• 使用Node, Gulp工具。

• 安装目录: 以下安装都在根路径/install 目录下, 即本说明文件目录下

• 全局安装Gulp

  > npm install -g gulp
  

• 运行npm

  > npm install
  

  [Mac电脑用户]: sudo npm install

• 运行gulp

  > sudo gulp
  

  • 说明: 因为ueditor打包需要安装grunt的原因，该命令行需执行两次。

• 安装ueditor

  > sudo gulp ueditor_cp && sudo gulp ueditor
  

手动方式

• 安装UEditor ｜ Smarty | PHPExcel

  • 下载 在线编辑器: UEditor (opens new window)

    • 下载 在线编辑器: [UEditor] [1.4.3.3 PHP 版本] UTF-8版
    • 解压 下载文件 到目录 utf8-php
    • 先备份misc/js/onlineditor/ueditor 目录下的文件 到 misc/js/onlineditor/ueditor_bak 下
    • 复制粘贴 utf8-php/ -> misc/js/onlineditor/ueditor 目录下
    • 复制粘贴 misc/js/onlineditor/ueditor_bak -> misc/js/onlineditor/ueditor 即可.

    [说明]

    UEditor下载版本为:[1.4.3.3 PHP 版本] UTF-8版

  • 下载Github库

    • Smarty : https://github.com/smarty-php/smarty
    • PhpSpreadsheet: https://github.com/PHPOffice/PhpSpreadsheet

  • 放置 Smarty 库, PhpExcel库

    • 放置 Smarty 库 -> install/vendor/smarty/smarty/ 目录下
    • 放置 PhpSpreadsheet 库 -> install/vendor/phpoffice/phpspreadsheet/ 目录下

FAQ

PHP 7 需知

• Since PHP 7 is not in the official Ubuntu PPAs,使用Composer install 会提示错误: Call to undefined function: simplexml_load_string(),解决办法在服务器上执行以下指令

  > sudo apt-get install php7.0-xml
  > sudo service php7.0-fpm restart
  

• Composer require phpoffice/phpspreadsheet doesn't work

  > sudo apt install php-xml
  > sudo apt install php7.0-gd
  > sudo apt install php7.0-mbstring
  > sudo apt install php-zip
  

Mac电脑运行gulp提示: ReferenceError: primordials is not defined

• 安装nvm[Mac OS 下 NVM 的安装与使用]: https://www.jianshu.com/p/622ad36ee020

  • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash
  • export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm

• nvm install 10.15.3

参考资料

• 安装Composer

  http://www.phpcomposer.com/

• 下载Smarty

  https://github.com/smarty-php/smarty

• 下载PhpSpreadsheet

  https://github.com/PHPOffice/PhpSpreadsheet

• 安装UEditor

  http://ueditor.baidu.com/website/download.html

• 安装NodeJs

  Installing Node.js via package manager (opens new window)

• 安装Gulp

  中文说明: http://www.gulpjs.com.cn/docs/getting-started/ 英文说明: http://www.gulpjs.com