README

## 基于 Yii2 和 Phundament4 的项目，使用 Gulp 作为资源生成工具

helptext 此项目旨在作为一个现场、实际运行的试点平台，通过提供移动文本和其他新兴沟通方式的管理，来赋予现有非营利性求助热线新的能力。该平台将允许与现有系统的集成以及升级，以便它们能够轻松地保持和转移标准、知识和技能。

一些功能

• 通过Phundamental 4简化配置文件
• 基于AdminLTE 2的仪表板主题，用于后端，并额外添加了字符插件
• 使用 RDAC 进行用户管理，以使用角色和权限
• 支持迁移，使用[Jon Chambers的yii2-migration-utility](https://github.com/c006/yii2-migration-utility)
• 基于[Jacob Moen zurbified](https://github.com/jacmoe/yii2-app-basic-zurbified)的 Gulp 配置，但不包含 foundation :)
• 集成多手机通话和短信提供商（例如 Twilio）

安装

先决条件

在开始之前，请确保您已安装composer和Node.js。如果您使用的是 Debian 或 Ubuntu，您可能还需要安装libnotify-bin软件包，该软件包用于 Gulp 通知您其状态。

复制.env-dist 文件

添加一个密钥http://randomkeygen.com/

Gulp

如果您之前还没有这样做，请全局安装 gulp

npm install -g gulp-cli

Browsersync

如果您之前还没有这样做，请全局安装 browsersync

npm install -g browser-sync

Composer

composer global require "fxp/composer-asset-plugin:~1.1.1"
composer update

安装后

初始化应用程序，选择“开发”

./init

安装后

在项目根目录中运行此命令来安装节点模块

npm install

安装成功后，使用以下命令构建项目

gulp build

要启动浏览器窗口并监视项目更改

gulp

要为生产优化（最小化等），请指定 production 标志

gulp build --production

和/或

gulp --production

开发环境说明

etc/apache2/sites-available configuration
<VirtualHost *:80>
    ServerName helptext.dev
    DocumentRoot "/var/www/helptext/htdocs/web"
    ServerAlias www.helptext.dev
    <Directory /var/www/helptext/htdocs/web>
            Options +FollowSymlinks
            AllowOverride All
            Order allow,deny
            allow from all
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/helptext.log
</VirtualHost>

您将拥有以下内容

ln -s ../local/.env .env

您需要在 .env 中配置短信提供商

配置短信提供商的 HTTP POST 请求 URL

http://www.yourdomain.com/en/message/call http://www.yourdomain.com/en/message/sms

您需要 swiftmailer 才能处理电子邮件

sudo apt-get update
sudo apt-get install libphp-swiftmailer

### 在共享托管环境中生产

• 您可能希望有机会创建自己的 Apache 配置文件，但您可以将以下内容添加到网站文件夹中的 .htaccess 字段

#  Add directives
RewriteEngine on

#  Change root directory to "web" folder
RewriteCond %{THE_REQUEST} ^GET\ /web/
RewriteRule ^web/(.*) /$1 [L,R=301]
RewriteRule !^web/ web%{REQUEST_URI} [L]

在网站文件夹中

allow from all

IndexIgnore */*

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule . index.php

• 如果托管有适当的安全措施，某些 PHP 函数（如 exec）将被禁用。您不需要它们来运行 yii2 或创建资源文件夹，但您希望能够在路上编译更少的内容，因此我们替换了 less 编译，并在进入预发布或生产之前运行 gulp。

### 部署时的故障排除

##env PROD #首先，如果有错误，请将 .env 改为 dev 并将调试模式设置为查看错误

错误：“内部服务器错误。”

• 应用正在运行，请检查.env中的数据库凭据

错误：“要发布的文件或目录不存在：/home/oechitchat/BDP2F17M/htdocs/src/../vendor/bower/jquery/dist”

• 将vendor文件夹中bower-asset文件夹的名称更改为bower

错误：无法查看图片

• 你是否在本地上运行了gulp？
• 删除生产环境中的资源以强制重新生成

###其他文档

• 创建新的迁移