安装和配置DreamFactory |积分。io API

安装和配置DreamFactory

在这一章中,您将了解如何安装和配置DreamFactory。许多安装的解决方案是可用的,包括GitHub库,点击安装,集装箱码头工人,成为特定于云计算的漏洞的安装程序。一定要仔细阅读组选项在作出决定之前,因为一些可能比其他人更适合您的特定情况。

选择一个DreamFactory版本

无论你想自旋向上DreamFactory实例在本地的笔记本电脑,在云环境中如AWS或谷歌云,或码头工人,我们有一个现成的解决方案为您服务!

DreamFactory GitHub库

克隆DreamFactory OSS库一直是目前最受欢迎的方式来访问软件。克隆存储库需要在本地机器上安装Git客户机或服务器,此时你可以使用下面的命令:克隆

美元git克隆https://github.com/dreamfactorysoftware/dreamfactory/

DreamFactory是建立在很受欢迎Laravel框架,这是建立在PHP。这意味着DreamFactory几乎是无所不在地支持所有托管环境;你只需要确保你的托管环境运行PHP 7.2或更高版本,最新版本的web服务器,比如Apache或NGINX,访问一个四个数据库用于存储配置数据(MySQL / MariaDB, PostgreSQL、SQLite和MS SQL server支持),而且您有足够的权限安装一些必要的PHP扩展。您可以了解更多关于所需的软件和扩展通过我们的维基:

https://wiki.dreamfactory.com/DreamFactory/Installation GitHub

码头工人

我们的集装箱码头工人是越来越受欢迎,包括所有你需要运行DreamFactory包括Ubuntu 16.04, PHP 7.1, NGINX web服务器。它还包括所有必需的PHP扩展,意味着你应该能够尽快开始尝试最新DreamFactory版本你可以旋转容器!更多地了解容器,去我们df-docker存储库:

https://github.com/dreamfactorysoftware/df-docker

Bitnami这样

许多用户只是想评估DreamFactory没有将任何时间或精力投入采购测试服务器或摆弄配置问题。如果你属于这一类,那么我们Bitnami这样指向-点击安装程序是为你!这些虚拟机包括所有你需要DreamFactory开始运行,并包括一个内置的数据库服务器,web服务器,PHP运行时,和其他一些有用的软件。

安装程序可用于Linux、Windows和Mac OS x通过以下链接下载你想要的版本:

https://www.dreamfactory.com/downloads

如果你使用DreamFactory商业Bitnami这样版,愿配置Oracle,遵循这些指令:

配置Oracle与Bitnami这样

云映像

云环境中托管解决方案的选择,并有充分的理由。云服务提供商提供无与伦比的稳定性、性能和安全,和无数的附加功能的能力最大化IT团队的效率,同时降低成本。DreamFactory提供Bitnami这样图像目标所有主要的云提供商,包括AWS, Azure,谷歌和甲骨文云。通过以下链接下载你想要的版本:

https://www.dreamfactory.com/downloads

从源代码安装和配置DreamFactory

如果你克隆了GitHub库,您需要执行一些额外的步骤开始之前你DreamFactory实例。第一步是确保您的服务器要求已经满足。让我们先来解决这些问题,其次是软件安装的概述。

配置你的服务器

本指南在重发展,某些地方是不完整的。我们建议阅读当前安装文档, 可以在这里。

服务器配置会根据您的操作系统有所不同。确保指令尽可能具体明了,我们打破了他们进入分章:

Debian / Ubuntu

如果你打算使用PHP结合的数据库,请检查下面相关分章:

如果你打算运行计划任务,请确保crond安装和操作系统上运行。你可以去看看crond systemctl状态,开始systemctl开始crond,并使它(启动时启动)systemctl启用crond。如果你没有安装它,你可以从你的包管理器(cronie在RHEL系统和cron在debian系统)。

服务器硬件要求

DreamFactory惊人性能即使在最低限度提供服务器,您需要64位的服务器上安装DreamFactory至少4 gb RAM。如果你计划在托管和DreamFactory系统数据库在同一台服务器上,那么我们建议至少8 gb RAM。这个服务器将房子不仅操作系统和DreamFactory,还需要一个web服务器如Nginx(推荐)或Apache和PHP-FPM。记住这些最低内存要求;许多客户可以DreamFactory更大的生产环境中运行。万博max手机网页登录

在重负荷需要负载平衡DreamFactory跨多个服务器,和利用共享缓存(复述或通常使用Memcached)和数据库层(房屋系统数据库)。

云环境	最小的服务器
AWS	t2.large
Azure	D2 v3
甲骨文云	VM.Standard.E2.1
数字海洋	标准8/160/5
谷歌云	n1-standard-2

尽管DreamFactory可以运行在Windows服务器和IIS,我们建议使用流行的Linux发行版,比如Ubuntu相反,Debian或CentOS为了利用我们的自动安装程序针对这些特定的操作系统。

启动你的项目之前,我们建议彻底测试api在估计生产负载下使用等工具万博max手机网页登录loader.io。

安装DreamFactory

第一步包括安装所需的PHP包使用作曲家:

作曲家安装——no-dev美元

的——no-dev选项告诉作曲家不安装development-specific依赖性。使用这些开发依赖我们的OSS社区和内部开发人员协助软件开发。你可以检查的列表都需要通过开放和发展依赖关系composer.json文件中发现项目的根目录。

如果你收到一个错误有关您的要求不能被解析成一个可安装的包,你不需要MongoDB,那么你可以通过另外提供快速障碍问题——ignore-platform-reqs作曲家运行时选项。

包安装,您将需要配置您的系统数据库。这个数据库将房子各种配置设置与您的实例相关联。为此DreamFactory支持四个数据库,包括Microsoft SQL Server、MySQL、PostgreSQL, SQLite。记住你需要首先创建这个数据库以及一个帐户DreamFactory将使用连接到它。

例如:PostgreSQL

一旦你有了一个PostgreSQL实例设置和服务器运行,您将需要创建一个用户(角色)DreamFactory登录,并使用一个数据库。最简单的是这样做是第一次切换到postgres用户在安装后会自动创建PostgresSQL:

sudo - i - u postgres

现在打开psql和创建您的新角色和数据库DreamFactory使用。(注意,如果您正在连接远程数据库服务器可以使用psql - h <主机> - u < ASuperUser > 5432 - p直接进入psql):

创建角色dfadmin登录密码“pghwosfg78”;创建数据库dreamfactory

请注意至少,用户必须登录权限

最后,最好仔细检查,PostgreSQL设置使用md5(我接受IPv6连接。e密码)登录。去你的pg_hba.conf文件和检查(或根据需要修改)你的以下的东西:

主持人::1/128 md5

你会通过运行一个终端命令配置系统数据库并回答一些提示你的数据库配置。

为此,运行以下命令在您的项目的根目录:

美元php工匠df: env * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *配置DreamFactory……* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *创建.env与默认的配置文件。phpunit)创建的。xml with default configuration. Which database would you like to use for system tables? [sqlite]: [0] sqlite [1] mysql [2] pgsql [3] sqlsrv > 1 Enter your mysql Host: > 192.168.10.10 Enter your Database Port [3306]: > Enter your database name: > dreamfactory Enter your database username: > dreamfactory_user Enter your database password: > Re-enter your database password: > CACHE DRIVER is not supported. Using default driver file. Configuration complete! ************************* WARNING! ************************** * * Please take a moment to review the .env file. You can make any * changes as necessary there. * * Please run "php artisan df:setup" to complete the setup process. * *************************************************************

与系统数据库配置,是时候创建系统表和种子数据,然后创建您的第一个系统管理员帐户。这是通过运行完成df:设置命令。因为涉及多个提示这个命令,我将命令输出分解成几个部分。后立即运行df:设置,命令将创建数据库表和种子数据:

美元php工匠df:设置* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *欢迎来到DreamFactory设置。* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *运行迁移…迁移成功创建表。迁移司机使用sqlite迁移:2015 _01_27_190908_create_system_tables迁移:2015 _01_27_190908_create_system_tables迁移:2015 _01_27_190909_create_db_extras_tables迁移:2015 _01_27_190909_create_db_extras_tables……迁移成功完成。* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *运行播种机……播种:AppSeeder应用资源创建:admi万博手机登录平台n, api_docs, file_manager播种:EmailTemplateSeeder邮件模板创建的资源:用户邀请违约,违约用户注册,密码重置默认创建的服务资源:系统,api_docs,文件、日志、数据库、电子邮件系统服务更新。服务资源创建:用万博手机登录平台户所有表成功被播种。

接下来会提示创建您的第一个系统管理员帐户:

创建第一个管理用户……输入你的名字:>杰森输入你的姓:> Gilmore输入您的电子邮件地址吗?:>jason.gilmore@dreamfactory.com Choose a password: > Re-enter password: > Successfully created first admin user.

最后,你会被提示,以确保您的应用程序的存储和引导/缓存目录是正确配置。这包括确保目录的所有权和权限设置正常使用乔恩和修改文件权限命令:

*请确认以下目录下的所有目录*他们可由web服务器读和写* - >存储/ * - >引导/缓存/ *例子:* > sudo乔恩- r{万维网用户}:{你的用户组}存储/引导/缓存/ * > sudo chmod - r 2775存储/引导/缓存

的{万维网用户}字符串是一个占位符的主人您的web服务器守护进程所有者。的{你的用户组}字符串是一个占位符,用于web服务器守护进程组所有者。

紧跟着这提示你应该通知成功的设置:

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *设置成功!* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *设置完成!您的实例已经准备好了。请启动*实例使用浏览器。您可以运行“php艺人服务”*尝试您的实例没有设置一个web服务器。* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

如果你安装和配置DreamFactory上运行一个web服务器,那么您可以打开您的浏览器并导航到的IP地址或域名。否则,如果您还没有安装web服务器,您可以运行php艺人服务:

php工匠为美元Laravel开发服务器开始:< http://127.0.0.1:8000 >

这将启动一个简单的PHP服务器上运行127.0.0.1港口8000年。打开你的浏览器,并导航到http://127.0.0.1:8000您应该看到下面的屏幕:

引入.env文件

它最好有不同的配置值基于应用程序运行的环境。例如,您可能想使用一个不同的本地缓存的司机比你在生产服务器上。万博max手机网页登录

为了小事一桩,Laravel利用DotEnv万斯·卢卡斯的PHP库。在新鲜Laravel安装中,您的应用程序的根目录将包含一个.env.example文件。如果你安装Laravel通过作曲家,这个文件将自动重命名.env。否则,您应该手动重命名文件。有关更多信息,请参阅官方Laravel文档

启用调试和日志记录

默认情况下,DreamFactory不启用调试由于性能问题。然而,它可以很容易地启用。在这个例子中.env文件下面你将看到这些选项居住。

# # = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = #环境设置# # = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = #使用安装程序。sh文件在这个目录中轻松地编辑这些设置。#默认情况下每个设置设置为其内部默认和注释掉了。# # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - # # #应用程序设置- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #应用程序名称中使用电子邮件模板和其他显示# APP_NAME = DreamFactory # aes - 128 - cbc加密密码选项或aes - 256 - cbc(默认)# APP_CIPHER = aes - 256 - cbc #返回调试跟踪异常:真或假(默认)# APP_DEBUG = false #环境中运行这个安装:本地万博max手机网页登录、生产(默认)APP_ENV =当地#使用php工匠关键:生成的生成一个新密钥。关键尺寸必须16、24或32。APP_KEY = base64: YOUR_APP_KEY # APP_LOCALE = en #日志设置。和/或日志文件是如何设置的。选项是单身(默认)、每日syslog, errorlog APP_LOG =每天#日志级别。这是分层的,按照以下顺序。#调试- >信息- >通知- >警告- >错误- >关键- >警报- >紧急#如果你设置日志级别警告所有警告,错误,关键,警报,紧急#将被记录。将日志级别设置为调试将记录一切。 APP_LOG_LEVEL=debug # When APP_LOG is set to 'daily', this setting dictates how many log files to keep. APP_LOG_MAX_FILES=5 # PHP Date and Time function timezone setting #APP_TIMEZONE=UTC # External URL representing this install #APP_URL=http://127.0.0.1:8000 # The starting point (page, application, etc.) when a browser points to the server root URL, #DF_LANDING_PAGE=/dreamfactory/dist/index.html DF_LICENSE_KEY=YOUR_LICENSE_KEY

努力使您的环境中运行时,DreamFactory建议调试开关,以及测井环境的敏感性增加。为了打开应用程序调试,请取消和更改以下值:

APP_DEBUG = true

您需要修改您的日志值取消和修改以下代码片段:

APP_LOG =每日APP_LOG_LEVEL =调试APP_LOG_MAX_FILES = 5

启用电子邮件注册

当创建新用户和管理员不理想也不安全为每一个手动设置密码。您可以启用邮件注册,将允许您发送电子邮件邀请通过检查发送电子邮件邀请选择。这将发送一封电子邮件邀请新用户包含一个链接到您的实例和允许他们设置一个密码。

启用电子邮件支持,你需要添加以下行.env文件,然后你可以发送新用户注册通知!

MAIL_DRIVER = smtp MAIL_HOST = smtp.gmail.com MAIL_PORT = 587 MAIL_USERNAME = YOUR_EMAIL@gmail.com MAIL_PASSWORD = YOUR_PASSWORD

请记住smtp不过是几个可用的交付选项之一。

增加你的会话一生

出于安全考虑,DreamFactory会话限制在60分钟。然而你可以改变一生,任何想要开你的持续时间.env文件,发现以下变量:

# DF_JWT_TTL = 60

改变DF_JWT_TTL任何时间你请,在几分钟内定义的。例如,以下设置将持续你的会议一个星期:

DF_JWT_TTL = 10080

更新你的DreamFactory码头工人的环境

DreamFactory环境仍然是一个半成品,但是许多用户积极使用它由于码头工人的简化配置和部署选项。偶尔你要更新的新版本DreamFactory我们组装以下指令作为指导。

你大概阅读本节的意图升级DreamFactory生产环境。万博max手机网页登录与任何软件一样,事情出错的和能做升级生产环境中,因此你被要求具备可存取的文件和系统数据库的备份和恢复计划之前升级。万博max手机网页登录我已经警告过你了!

首先打开终端,输入DreamFactory实例的根目录。然后执行这个命令:

美元docker-compose exec web猫.env | grep APP_KEY APP_KEY = base64: U / En8zI8WKrZ F7CA9KncWjGTIhbvpGD5wN3eLoDZuQ =…

几行输出将被返回,但是你应该只复制行开始APP_KEY到一个文本文件。记住在最低你需要复制下来APP_KEY价值。如果你覆盖其他违约,如类型、位置、和凭证与系统相关联的数据库,您需要复制。是非常重要的您执行这个步骤,否则你会遇到各种各样的upgrade-related问题。

接下来,运行以下命令:

git标签——列表2.1 2.14.1 2.2美元2.2.1……

这将显示所有标记的版本。首先,停止运行DreamFactory容器没有删除它。请记住,当你运行这个命令,DreamFactory实例将离线,直到完成升级过程:

美元docker-compose停止停止df-docker_web_1…做停止df-docker_mysql_1……做停止df-docker_redis_1……完成

对于本示例中,我们将假定您正在运行2.12和想升级到2.14.1。所以你首先想结帐2.14.1标签:

美元/ 2.14.1 git checkout标签

接下来,您将需要添加APP_KEY到docker-compose.yml文件。开放docker-compose.yml在代码编辑器中,向下滚动到网络服务和添加APP_KEY属性和关联值与其他环境变量:

…DB_DATABASE: dreamfactory APP_KEY:“base64: U \ / En8zI8WKrZ \ / F7CA9KncWjGTIhbvpGD5wN3eLoDZuQ = ' CACHE_DRIVER:复述,…

封装是至关重要的 APP_KEY 值在单引号,此外逃脱一个反斜杠正斜杠出现在你的钥匙!作为一个例子,比较 APP_KEY 条目发现上面有显示的输出。

保存这些更改,然后重建你的容器使用以下命令:

美元docker-compose - d——构建

一旦完成,您可以运行下面的命令来确认容器启动并运行:

美元docker-compose ps命令名称国家港口- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - df-docker_mysql_1 docker-entrypoint。sh mysqld 3306 / tcp, 33060 / tcp df-docker_redis_1 docker-entrypoint。sh复述,…6379 / tcp df-docker_web_1 / docker-entrypoint。sh 0.0.0.0:80 - > 80 / tcp

如果出事了,一个容器显示它已经退出,您可以查看日志的容器:

美元docker-compose web日志

假设容器启动并运行,接下来需要确定DreamFactory系统数据库模式已经改变了。运行这个命令这样做:

docker-compose exec web php工匠迁移:美元地位

如果你看到Y在表格输出跑吗?列,那么模式没有改变。如果你看到N在任何时候,你需要运行以下命令来更新你的系统数据库模式:

美元docker-compose exec web php工匠迁移

最后,你要清楚你的应用程序和配置缓存通过执行以下命令:

美元docker-compose执行php web工匠配置:明确配置缓存清除!美元docker-compose exec web缓存php工匠:清除缓存清除成功。

完成,在浏览器中打开DreamFactory实例,并确认环境操作。

安装和配置在CentOS DreamFactory

第一把CentOS码头工人的形象。

码头工人拉centos美元

然后我就图像处于分离状态。

码头工人美元运行itd {Container_ID}

一旦图像运行我们可以进入并开始安装DreamFactory。

码头工人exec - {Container_ID} /bin/bash美元

使用DreamFactory安装脚本

而不是花时间复制和粘贴是一长串的命令我们要用我们的安装脚本,可以找到在这里。

开始我们将不得不把脚本到我们的容器使用wget。

wget - o cent.sh {RAW_GITHUB_SCRIPT_URL}

现在,我们已经在我们的服务器端脚本,让它可执行文件。

chmod + x cent.sh

我们现在可以运行脚本,但是首先让我们看看其他配置标志。你可以通过几个选项到脚本改变其行为。如果你不使用这些选项,该脚本将安装Nginx web服务器,DreamFactory,和所需的系统和PHP扩展,但意志没有安装数据库服务器。看到一个安装选项的完整列表我们检查它在这里,否则我们将使用——使用mysql国旗能够使用MySQL作为数据库系统。

现在我们可以运行脚本!

sudo。/分。sh——使用mysql

您现在应该看到脚本运行一样。

在完成你现在可以去你的浏览器并访问您的实例!

选择一个HTTP客户端

API是否消费者是一个iPhone或Android应用程序,一个水疗中心(单页面应用程序),或者干脆另一个服务器,消费者通常被称为客户端。REST API客户端问题的HTTP请求,解析响应和相应的反应。尽管在大多数情况下,您的团队将使用库等Alamofire或Axios来管理这些请求,你会经常想与api的交互更加流畅的方式在调查和学习阶段。API文档特性符合这种需求,然而API文档接口缺少书签和其他持续查询的能力,管理参数以编程方式使用变量和其他功能用于维护一组容易配置。

幸运的是,有许多的HTTP客户端填补这一空白。两个最受欢迎的失眠和邮递员,可以在OSX和多个操作系统,分别。在本节中,我们将向您介绍两个HTTP客户端,以及一个额外的好处讲无处不在的旋度的客户很有可能是最受欢迎的软件你从来没听说过。

失眠

失眠是一个跨平台的REST客户端,之上的电子。失眠是realtively新的现场比旋度和邮递员,但提供了一群特性,当然使其竞争力。他们有一个非常漂亮的UI,和大量的功能,包括一个团队的选择。

邮递员

邮递员是一个久经考验的GUI界面的文档来帮助您设置您的测试环境。他们计划每个人,从免费个人用户,企业团队。邮递员也有一个很好的特性API网络示例API调用,从各种各样的来源。它绝对值得一看。

旋度

旋度的缺乏一个抛光界面会让你相信这是不如失眠和邮递员。不是这样的!旋度是一个无与伦比的能力的软件。旋度是一个命令行工具和库对于URL语法的传输数据,支持HTTP、HTTPS、FTP、FTP,小田鼠,TFTP, SCP, SFTP, SMB, TELNET, DICT、LDAP、LDAP、文件,IMAP, SMTP、POP3、RTSP和RTMP。

DreamFactory运行在高可用性、负载均衡环境

大多数高体积API请求用户运行DreamFactory在高可用性、负载均衡环境。下图描述了这种方法:

如果你不感兴趣运行DreamFactory平台本身的HA集群然后无视“二级环境”中找到“DreamFactory应用程序集群”层不过图的其余部分仍适用于一个纯粹的负载平衡的环境。在这两种情况下,负载均衡DreamFactory实例将由缓存和系统数据库层。对缓存DreamFactory支持Memcached和复述。在系统数据库方面,DreamFactory支持MySQL、PostgreSQL, Microsoft SQL Server。

使用Bitnami这样安装

这些指令配置驱动程序与DreamFactory商业Bitnami这样版。

Bitnami这样Linux甲骨文

本节开始,按照步骤1 - 3发现Bitnami这样的文档:

Bitnami这样的文档

一旦完成,你需要完成一个步骤。SSH到DreamFactory Bitnami这样安装的服务器托管,并导航到php / bin /目录中安装目录。供参考的目的,我们将使用INSTALL_DIR占位符来引用这个目录/

$ cd / INSTALL_DIR / php / bin

接下来,运行以下命令,确保你的前缀php命令。/:

美元/ php——ini

在输出中您将会看到以下行:

加载配置文件= > / opt / dreamfactorygold-3.0.1-0 / php / etc / php . ini

的价值加载配置文件标识Bitnami这样的位置php . ini配置文件。记住你的路径可能不同于上面提到的例子。打开这个php . ini文件的文本编辑器和寻找这条线:

;扩展= oci8.so

取消它通过删除分号并保存更改。现在重启Bitnami这样的Apache服务器:

cd / INSTALL_DIR /美元。/ ctlscript重启apache

一旦重新启动你的DreamFactory Bitnami这样实例能够连接到一个数据库。配置一个新的API使用DreamFactory服务连接器后,头到API文档选项卡来确认你可以连接到数据库。最简单的方法之一是通过执行以下端点:

GET / _table检索一个或多个表。

执行这个端点将导致从连接数据库返回的表列表。

Bitnami这样Windows甲骨文

首先下载Oracle即时客户在这里。自从Windows Bitnami这样堆栈是64位的,你需要下载64位的即时的客户。

在成功下载zip文件现在可以提取您的首选位置,如C: \ instantclient_X_X。

在你编辑下面的线php . ini文件(C: \ Bitnami这样\ dreamfactory-x.x.x-x \ php \ php . ini)通过移除扩展前的分号。如果你安装即时客户19开始时你仍将扩展根据12 c。这是PHP将识别司机的唯一途径。

= php_oci8_12c;扩展。dll;使用Oracle数据库12 c即时客户

现在我们必须使我们的Windows机器上意识到司机,去控制面板- >系统- >高级系统设置。

点击环境变量和系统变量下,双击路径。的变量值,添加即时客户目录的路径。使用分号来单独的这个新条目从当前条目。

C: \ instantclient_X_X

重新启动系统。

故障排除Oracle连接

DreamFactory使用PHP的OCI8库与数据库连接和交互。因此成功安装客户端驱动程序和SDK是一个至关重要的过程的一部分。有时是有用的尝试连接之外的DreamFactory为了进一步隔离问题。这样做的一个方法是通过将下面的PHP脚本DreamFactory在同一台服务器上安装位置:

< ?php $康涅狄格州= oci_connect(“用户名”、“密码”、“主机/数据库”);如果(! $康涅狄格州){$ e = oci_error ();回声“无法连接到:”;echo $ e(“信息”);其他}{回声“成功地连接到”;}oci_close(康涅狄格州);? >

取代用户名,密码,主机/数据库占位符您的凭据,脚本名称. php或类似的,将其放入公共DreamFactory安装目录。然后打开一个浏览器并导航到https://YOUR_DOMAIN/.php。如果连接成功,您将看到一个相应的消息;否则你应该看到一些额外的细节与错误的本质。

为DreamFactory配置火鸟

这些指令是为安装的火鸟司机源代码。

安装火鸟驱动程序

cd / tmp git克隆https://github.com/php/pecl-database-interbase.git cd pecl-database-interbase / apt-get安装firebird-dev autoconf phpize建设重要——清洁phpize。/配置使make install

下载完成后,你会想让司机在php。ini文件。之后,启用扩展的扩展将出现在列表中。

php - m (php模块)

故障排除

如果你收到一个500错误的消息内容必须是一个字符串或对象的响应,确保你的数据库配置为UTF8。

配置为DreamFactory Microsoft SQL Server

配置Microsoft SQL Server使用DreamFactory是一个两步的过程:

配置您的SQL服务器实例接受ODBC连接。
配置您的DreamFactory服务器允许PHP和SQL server。

这是一个相当简单的过程,前者的指令根据SQL Server版本略有不同。为了使事情很简单,我们打破了这一章了。

步骤# 1。配置您的Microsoft SQL Server

安装Microsoft SQL Server的ODBC驱动程序

Microsoft SQL Server 2017
Microsoft SQL Server 2013
Windows 7, Windows 8, Windows Server 2008 R2, Windows Server 2012、Windows Vista Service Pack 2

https://www.microsoft.com/en-us/download/details.aspx?id=36434

Windows 10, Windows 7, Windows 8
Windows Server 2008、Windows Server 2012、Windows Server 2016
微软SQL Server的ODBC驱动程序

首先,你需要下载如果不是已经安装的ODBC驱动程序。你可以下载SQL Server 2011驱动程序在这里。

Microsoft SQL Server 2011

微软SQL Server的ODBC驱动程序

首先,你需要下载如果不是已经安装的ODBC驱动程序。你可以下载SQL Server 2011驱动程序在这里。

在Windows服务器上安装DreamFactory IIS10

注意:这些安装说明假设“全新安装IIS。可能会有部分已经完成或安装。如果是这样的话,跳过的部分不再适用于你的情况。这些指令是只关心DreamFactory的安装。请咨询您的Windows管理员硬化web服务器和其他安全控制这些指令的范围之外。

安装PHP IIS

在开始安装之前下载的Web平台安装程序为IIS在这里。

在Web平台安装程序,导航到万博max手机网页登录产品选项卡并选择框架从侧边栏。选择适当的PHP版本。在我们的示例中,我们使用PHP 7.4.1 (x64)。

点击添加,然后安装在底部。按照屏幕上的提示接受的EULA PHP安装IIS。

设置PHP模块映射在IIS 10(如果需要)

一旦成功安装PHP,它必须建立在IIS10。

打开IIS服务经理从侧边栏,单击服务器名称。
双击处理程序映射PHP需要与FastCGI处理程序在PHP目录。

注意:如果PHP安装使用Web平台安装程序应该有FastCGI处理程序映射关联。检查是正确的关联和对应于你的本地服务器。列表中的默认处理程序映射的名称映射PHP_via_FastCGI这是您将需要doublecheck映射。点击好吧。

如果PHP FastCGI的默认处理程序映射没有列出你现在需要添加:

在IIS管理器功能面板,双击该处理程序映射功能。

一旦打开,单击添加模块映射在右边。输入以下信息与php-cgi执行本地服务器的路径:

变量	值
请求路径	*。php
模块	FastCgiModule
可执行的	“C: \ Program Files \ PHP \ v7.4 \ php-cgi.exe”
的名字	PHPviaFastCGI

点击好吧,然后单击是的来确认。
使用Internet信息服务(IIS)经理点击您所使用的服务器并单击重新启动从操作面板。

测试PHP IIS

为了测试PHP,我们要创建一个PHP web根目录内的信息文件。通常情况下,这个目录位于:

C: \ inetpub \ wwwroot

在webroot目录中,创建一个空的PHP文件。顶部的文件类型如下:
```
< ?php phpinfo ();
```
info.php保存文件。确保文件名和扩展信息。php,而不是info.php.txt。这将是没有显示如果启用了隐藏已知文件类型的扩展文件夹选项。确保这是未经检查,如果需要从文件夹选项:
从浏览器,导航到phpinfo您刚才创建的文件。通常情况下,在新服务器上安装它http://localhost/info.php在您的web浏览器。

如果你收到404.0错误,一般情况下,问题是,扩展不是。php或文件权限设置不正确。403.3如果你收到以下消息错误,PHP必须正确设置MIME类型,请确保您遵循IIS PHP设置部分。如果你看到一个空白页面,您可能需要启用php的调试错误。ini文件。或者,您可以查看php的输出误差。更多信息日志。
如果安装成功,您应该看到一个PHP信息页面在浏览器中。保持这个文件,直到你完成剩下的配置,然后删除它之后,该文件包含特定于系统的信息。

一旦你有PHP设置和使用IIS,你准备安装DreamFactory并将其添加在IIS网站10。

在IIS上安装DreamFactory 10

你需要遵循所需的软件和扩展部分,以确保你有Git,作曲家和MongoDB司机,如果需要的话。完成后,下面描述了如何安装Dreamfactory IIS 10。

注意:我们将使用SQL Server作为DreamFactory外部服务数据库。如果你还没有,你将需要购买DreamFactory订阅在安装之前,所以适当的依赖可以添加到您的安装。请联系支持额外的信息。如果你决定不升级,你仍然可以通过跳过安装这个df: env命令,直接进入df:设置命令。这将创建一个SQLite数据库作为系统数据库在我们所有的GitHub(这是默认安装)。

接下来,打开一个命令提示符,壳牌,Git或Windows客户端
的提示,导航到您想要安装的目录DreamFactory。通常,这将是:

C: \ inetpub \ wwwroot \

但是你可以选择任何你想要的位置。我们将添加这个网站在IIS。在这个例子中,我们选择:

C: \ inetpub \ wwwroot \ dreamfactory

DreamFactory执行Git克隆到该目录:

git克隆https://github.com/dreamfactorysoftware/dreamfactory

这将拉下的主分支DreamFactory叫到一个目录。/ dreamfactory。

导航到dreamfactory目录和安装使用作曲家依赖关系。对于生产万博max手机网页登录环境,使用——no-dev选择一个开发环境,否则丢弃。如果你不运行或计划运行MongoDB,添加-ignore-platform-reqs:

作曲家——ignore-platform-reqs no-dev更新

否则运行以下命令安装的依赖关系:

作曲家安装——no-dev

DreamFactory设置命令行运行向导。这将设置为数据库设置、配置和提示您第一次管理用户帐户,等。它还将允许您更改环境设置中途,然后运行一遍完成设置。

和我们其他的安装一样,第一个命令允许您选择和配置您的系统数据库(SQLite、MySQL、PostgreSQL或该软件)。你也可以改变这里的环境设置。

php工匠df: env

第二个命令允许您完成配置,添加你的第一个管理账户,等等。

php工匠df:设置

按照屏幕上的提示完成设置。

DreamFactory网站添加到IIS管理器

打开IIS管理器
从操作列,选择Add Web站点
在对话框中输入所有相关信息。在物理路径字段中,输入的路径DreamFactory安装公共文件夹中。

为您的实例输入你的主机名。
单击OK启动该服务。

注意:确保你DreamFactory站点是默认的站点。默认情况下,将会有一个网站上面DreamFactory站点调用“默认网站”。如果你不能够访问DreamFactory在URL,试着删除“默认网站”

增加IIS URL重写规则

您将需要手动添加重写规则IIS 7。为此遵循以下步骤:

单击DreamFactory网站,然后选择URL重写。
从操作列,选择导入规则。
导航到. htaccess文件/公共DreamFactory安装的目录配置文件输入,然后单击进口。的. htaccess文件将自动转换为XML。
在树视图中,找到任何规则,一个红色的X图标。点击这个规则,它将突出显示重写规则对话框。

删除该规则在重写规则对话框和重复这个任何额外的规则,直到你看到所有绿色复选框。
点击应用在操作列中。

添加您的IIS主机到主机文件

一旦完成,最后一步是添加您的主机(IIS) DreamFactory站点到您的主机文件。主机文件应该位于这里

C:\Windows\System32\drivers\etc

一旦你已经找到文件,编辑它将条目添加到的IP地址和主机名添加DreamFactory IIS设置——的例子

10.10.10.10。df.local.com

确保DreamFactory缓存和日志目录可写的

您将需要以下目录上设置权限,以确保它们是可写在DreamFactory安装文件夹。这些都是:

存储/框架/缓存/
存储/框架/视图/
存储/ logs /

请确保用户组已经完全控制这些目录来启用创建日志文件、缓存文件,等。可选地,如果您正在使用的包括sqlite数据库测试,请确保存储/数据库/目录还编写和修改权限。重新启动web服务器并导航到您的DreamFactory安装。如果你在本地环境测试,你可以在主机文件中添加一个FQDN允许本地Dreamfactory站点导航。

配置Apache与DreamFactory Windows

尽管DreamFactory nginx和方便的linux安装程序包含配置Apache开箱即用的,Windows(如果你想使用Apache而不是IIS如前所述),我们将需要做一些配置。下面是一个基本的指南在Windows上安装Apache。你应该联系你的Windows管理员安全控制和组织可能需要特定的配置。

提醒!

记得运行情况(如命令提示符)作为管理员在处理窗口。

安装Apache

在Windows上安装Apache是一个相对轻松的任务。可以从一个Win64二进制Apache休息室下载后,可以提取c: \。(其实你可以把你喜欢的地方,你只需要改变的路径控制httpd . conf文件)。提取的文件后,下载Visual c++可再发行的VC_redist.x64.exe也可以在Apache休息室的网站,并运行程序。

现在,测试,打开一个命令提示符,去c: \ Apache24 \ bin和运行httpd命令。如果你去本地主机您应该看到“这工作!“在浏览器窗口中。

配置PHP和Apache

我们必须使用线程安全版本的php为了使用Apache。这可以从下载PHP的网站为了简单起见,应提取c: \ php。

PHP . ini文件,至少应该有以下扩展激活:

旋度ffi ftp阻止gd2 gettext ldap mbstring exif mysqli odbc openssl pdo_firebird pdo_mysql pdo_oci pdo_odbc pdo_pgsql pdo_sqlite pgsql shmop soap插座sqlite3整洁xmlrpc钠

PHP将被添加到您的路径- >搜索“环境”在Windows搜索框,然后单击“编辑系统环境变量”,到“高级”选项卡,点击“环境变量”。在系统变量选择“路径”,然后“编辑”,然后“新”。添加c: \ php并保存。的路径应该在列表的底部。

现在我们将告诉Apache PHP。去c: \ Apache24 / conf并打开httpd / conf配置文件。在底部添加以下:

# 74年PHP模块PHPIniDir LoadModule php7_module“C: / PHP C: / PHP / php7apache2_4。dll”AddType / x-httpd-php。php应用程序

然后在LoadModule部分取消注释以下模块:

deflate_module filter_module access_compat_module rewrite_module

我们可以测试都是通过创建一个工作info.php文件在Apache24 /根用下面的句子:

< ?php phpinfo () ?

重新启动httpd去localhost /根你应该看到php屏幕上的信息。

与Apache配置DreamFactory

最后,我们需要得到DreamFactory和Apache和彼此说话。对于这个示例,它假定DreamFactory已经安装c: / dreamfactory。

首先,回到我们httpd . confApache文件,找到DocumentRoot " $ {SRVRoot /根}"。我们将改变DocumentRoot,目录,和配置。

从“DocumentRoot”到“替换为以下几点:

DocumentRoot“c: / dreamfactory /公众”<目录" c: / dreamfactory /公共" > AddOutputFilterByType缩小application / json文本/纯文本/ css / javascript应用text / xml应用程序/ xml应用程序/ xml rss text / javascript +选择索引+ FollowSymLinks multiviews方法AllowOverride所有AllowOverride没有要求所有授予RewriteEngine RewriteBase / RewriteCond % {REQUEST_FILENAME} ! - f RewriteCond % {REQUEST_FILENAME} ! - d RewriteRule ^。* $ /索引。php[L]  Allow from all

保存并运行httpd - t从命令提示符(从c: \ Apache24 \ bin)你不应该得到任何语法错误。启动服务器和httpd去localhost / dreamfactory / dist和你将会受到登录屏幕。

Apache设置https

我们可以在Apache设置https使用虚拟主机。对于本例,我们将通过http dreamfactory运行在端口80上,和在端口443 https:// < yourservername >。

去您的Apachehttpd . conf文件和第一次取消模块ssl_moduleLoadModule部分。

现在,我们将使用我们之前的配置,然后把它赋值给一个虚拟主机/端口80。把以前的配置和包装它< VirtualHost *: 443 >…< /虚拟主机>标签也提供一个servername。最终它应该看起来像这样:

听80 < VirtualHost *: 80 > DocumentRoot“c: / dreamfactory /公众”ServerName < yourservername > <目录" c: / dreamfactory /公共" > AddOutputFilterByType缩小application / json文本/纯文本/ css文本应用程序/ javascript / xml应用程序/ xml应用程序/ xml rss text / javascript +选择索引+ FollowSymLinks multiviews方法AllowOverride所有AllowOverride没有要求所有授予RewriteEngine RewriteBase / RewriteCond % {REQUEST_FILENAME} ! - f RewriteCond % {REQUEST_FILENAME} ! - d RewriteRule ^。* $ /索引。php[L]  Allow from all

现在,复制粘贴下面的一切,改变虚拟主机到443,并添加SSL配置,所以它最终看起来像下图:

听443 < VirtualHost *: 443 > DocumentRoot“c: / dreamfactory /公众”ServerName < yourservername > SSLEngine SSLCertificateFile上“证书> <路径”SSLCertificateKeyFile“<关键路径>”<目录" c: / dreamfactory /公共" > AddOutputFilterByType缩小application / json文本/纯文本/ css文本应用程序/ javascript / xml应用程序/ xml应用程序/ xml rss text / javascript +选择索引+ FollowSymLinks multiviews方法AllowOverride所有AllowOverride没有要求所有授予RewriteEngine RewriteBase / RewriteCond % {REQUEST_FILENAME} ! - f RewriteCond % {REQUEST_FILENAME} ! - d RewriteRule ^。* $ /索引。php[L]  Allow from all

重新启动Apache服务器,您现在应该有两个网站,1 / localhost, 1 / https://localhost

提示

如果你想要任何进来通过http重定向到https,那么您可以简单地编辑以下端口80虚拟主机:

听80 < VirtualHost *: 80 > ServerName < yourservername >重定向/ https:// < yourservername > / < /虚拟主机>

配置SAP SQL在任何地方

SAP SQL任何同名的商业软件巨头SAP本身提供的数据库解决方案。如果您的组织依赖SQL在任何地方,你会很高兴知道DreamFactory金银版包括支持这个强大的数据库!在这一章里,我们将带您通过服务器配置必要步骤,以确保您的DreamFactory实例可以在任何地方与SQL数据库。

安装PDO和PDO_DBLIB扩展

DreamFactory与SQL的任何地方通过PHP数据对象(PDO)扩展。它的工作原理与一个特定于数据库的PDO司机与各种各样的数据库接口。幸运的是,PDO扩展和相关的驱动程序非常容易安装。你可以确认是否PDO已安装运行这条命令:

php - m美元……PDO……

如果PDO不出现在安装扩展的列表,搜索你的包管理器来识别PDO包。例如在CentOS你会寻找PDO包一样:

$ sudo百胜搜索pdo……php71-php-pdo。x86_64 php72-php-pdo.x86_64 php73-php-pdo.x86_64

确定所需的PHP版本你可以安装它:

yum安装php72-php-pdo.x86_64美元

接下来你要安装SQL任何驱动程序。令人困惑的是,这个驱动程序通常会将其作为“Sybase”,因为SAP SQL的地方被称为Sybase SQL之前任何SAP 2010收购Sybase,和PHP社区还没有抽出时间来更新扩展的名字。在Debian / Ubuntu可以安装驱动程序使用这个命令:

$ sudo apt安装php7.2-sybase

在CentOS这个驱动程序识别“pdo-dblib”,因为“dblib”是去图书馆的名字用于在客户端与数据库之间传输数据,支持一个协议被称为表格数据流(TDS -更多关于这一点)。然而作为一个方便的软件包管理器你可以搜索词“sybase”和所需的驱动程序将返回:

$ sudo百胜搜索sybase……php70-php-pdo-dblib。x86_64 php71-php-pdo-dblib.x86_64 php72-php-pdo-dblib.x86_64 php73-php-pdo-dblib.x86_64

现在你知道这个名字你可以安装所需的版本:

$ sudo yum安装php72-php-pdo-dblib.x86_64

一旦完成,运行php - m再次确认PDO和pdo_dblib扩展安装:

php - m美元……PDO pdo_dblib……

完成这一步之后,让我们继续安装和配置FreeTDS。

安装和配置FreeTDS

FreeTDS是一个开源实现的协议称为表格数据流(TDS)。这个协议在任何地方都使用SQL和Microsoft SQL Server数据库之间传递数据的一种方式和各自的客户。因此DreamFactory服务器需要一个TDS库,允许它与这些数据库和FreeTDS套装,需要很好地。

打开/etc/freetds/freetds.conf

也就是说,DreamFactory不会与树的司机。DreamFactory SAP SQL的任何支持

https://cubist.cs.washington.edu/doc/FreeTDS/userguide/x631.htmhttps://www.freetds.org/userguide/ChoosingTdsProtocol.htmlhttps://www.freetds.org/userguide/freetdsconf.htmlhttps://docs.microsoft.com/en - us/sql/linux/sql -服务器- linux -设置- tools?view=sql -服务器- 2017

看到/ etc / profile:出口SQLANY17 = / opt / sqlanywhere17 (https://forums.suse.com/archive/index.php/t - 2562. - html)

故障排除您的配置

一个简单的方法来确认司机正确安装在任何地方,您的SQL数据库可以通过运行下面的命令在您的Linux shell。的SA_HOST,SA_PORT,SA_DB,SA_U,SA_PWD是占位符您的SQL主机IP地址或域名,港口,数据库名称、用户名和密码,分别为:

TDSDUMP = " tds。日志" \ php - r "新PDO (“dblib:主机= SA_HOST: SA_PORT; dbname = SA_DB ',‘SA_U’,‘SA_PWD);“

调用PHP使用- r选项会导致后面的命令使用PHP解释器执行。我们的前缀php调用创建的TDSDUMP环境变量。当这个变量集,它将导致所有流量发送到FreeTDS登录到指定文件,在这种情况下tds.log。一旦这个命令完成,tds.log文件将被发现在您的当前目录,将包含相当多的信息沟通工作流程与试图连接到SQL通过PHP的PDO扩展。

使用SAP的PHP扩展

几年前SAP发布自己的原生SQL PHP扩展的任何地方,与小背景信息为什么应该使用这个扩展在PHP的PDO-based方法的偏好。需要澄清的是,DreamFactory不支持SAP PHP模块;相反,我们依靠PHP的长期支持SQL通过PDO和地方PDO_DBLIB扩展。

说,我们认识到您可能希望使用PHP与SQL数据库之外的任何地方DreamFactory-generated api和因为文档在这个问题是如此的严重缺乏我们认为它可能是有用的,包括一些问题的引导,造福所有PHP用户。在你的配置和测试这个模块自定义PHP应用程序(不是DreamFactory),遵循这些指令:

导航到以下网址下载安装PHP版本的PHP模块匹配:

https://wiki.scn.sap.com/wiki/display/SQLANY/The + SAP + SQL + + PHP +模块

你可以很容易地确定PHP版本安装在您的服务器使用以下命令:

php - v php 7.1.22-1 + 0 ~ 20181001133629.6美元+杰西~ 1。113英镑f3b (cli)……

模块的zip文件移动到您的服务器

以下命令将解压该文件并将其内容命名的目录中sqlanywhere-driver发现在您的系统/ tmp目录:

解压sqlanywhere - php 7.1 - _linux美元。zip - d / tmp / sqlanywhere-driver

如果您的Linux服务器是一个新的实例,您可能需要先安装解压缩包。例如在Ubuntu / Debian你运行这个命令这样做:

$ sudo apt安装解压缩

接下来你会移动php7.1.0_sqlanywhere.so模块到PHP扩展目录。你可以学习扩展目录的路径通过这个命令:

php -美元| grep extension_dir extension_dir = > /usr/lib/php/20160303 = > /usr/lib/php/2016030

有几个版本的这个模块。你会发现在32位版本/ tmp / sqlanywhere-driver / bin32目录,和64位版本/ tmp / sqlanywhere-driver / bin64目录中。此外,这些各自的目录包含一个线程安全的并不是线程模块。如果你使用PHP的CGI或Apache版本1。X,您将使用非线程模块。如果你使用Apache 2。X或NGINX,您将使用线程版本,用的_r文件名后缀。

https://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.sqlanywhere.12.0.1/dbprogramming/php s - 6029035. - html

更新php。ini文件并重新启动web服务器

最后,您需要更新php . ini文件以确保PHP认识到新的模块。你可以学习这个文件的位置使用以下命令:

php——美元ini……加载配置文件:/etc/php/7.1/cli/php.ini……

在此基础上输出,php . ini文件位于/etc/php/7.1/cli/。不过,请记住这一点php . ini文件是只有结合使用PHP运行时通过命令行接口(终端)。你也要修改php . iniPHP文件时使用与web服务器进行交互。运行时的位置并不明显php—ini然而,如果你导航到cli目录的父母你会发现住房web服务器特定的目录php . ini文件:

$ cd /etc/php/7.1/ $ ls输入cli fpm mods-available $ ls输入/ conf.d php . ini

因此你要更新这两个php . ini文件,以确保SQL模块是公认的在两种环境中任何地方。这样做,你会在文本编辑器中打开每个文件并添加一行:

扩展= php-7.1.0_sqlanywhere_r.so

如果你在少数的用户和需要线程版本,你会而不是引用线程版本:

扩展= php-7.1.0_sqlanywhere.so

请记住这个引用的名称必须匹配文件复制到PHP扩展目录!

一旦完成,保存更改,并重新启动web服务器。确认PHP CLI环境识别模块通过运行这条命令:

php - m美元| grep sqlanywhere sqlanywhere

接下来,确定PHP的web环境识别模块通过创建一个名为phpinfo的文件。php在web文档根目录并添加以下

有用的系统管理记录

创建一个新的用户Sudo

它有害的实践作为根用户运行系统命令,除非绝对必要。您应该创建一个用户可以执行命令Sudo代表另一个用户,默认情况下根用户。要做到这一点,您将首先创建一个新用户(跳过这一步如果你不是想sudo功能添加到现有的用户:

美元adduser wjgilmore添加用户“wjgilmore”……添加新组“wjgilmore”(1000)…添加新用户“wjgilmore”(1000)组“wjgilmore”……创建主目录“/ home / wjgilmore”……复制文件从/ etc / skel”…进入新的UNIX密码:重新输入新的UNIX密码:密码:密码更新成功更改用户信息对于wjgilmore输入新值,或按Enter键默认全名[]:[]号房间:工作电话[]:家庭电话[]:[]:信息正确吗?[Y / n] Y

接下来,您将添加的用户sudo组:

美元usermod ag sudo wjgilmore

一旦完成,您可以执行命令在命令前面加上与升高sudo:

$ sudo。/ build_system.sh

有关更多信息,请参见万博手机登录平台这些资源:

https://linuxize.com/post/how-to-create-a-sudo-user-on-debian/

升级您的DreamFactory实例

非常DreamFactory落入“建立和忘记”软件类别,通常在后台服务api数月甚至几年没有进一步的人工干预。然而,我们鼓励用户定期升级利用新特性,更不用说增强的性能和稳定性。DreamFactory也依赖于许多依赖关系,如PHP偶尔与安全漏洞。因此,你要小心确保操作系统和dependecies修补。

幸运的是,DreamFactory升级到最新版是一个相当简单的过程。在本节中,我们将带您通过这个过程。

步骤# 1。备份当前DreamFactory配置设置

一个文件命名.env驻留在你当前DreamFactory实例的根目录。这个文件包含许多重要的系统设置,包括数据库凭证、缓存的偏好,和其他关键配置。备份你的.env文件中,导航到DreamFactory根目录并复制文件到另一个目录:

cd / opt / dreamfactory cp .env美元~ / .env

接下来,使用SFTP或另一个可用的文件传输机制.env复制到另一个位置以外的服务器。请务必把这额外的预防措施来避免失去任何不可预见的问题,可能会导致文件丢失。

步骤# 2。备份DreamFactory系统数据库

接下来,我们将创建一个生产DreamFactory系统数据库的备份。万博max手机网页登录四个系统数据库支持,包括MySQL、PostgreSQL, MS SQL Server, SQLite。我们将演示一个MySQL数据库备份,不过放心同样简单的备份机制存在其他供应商。只要记住你要备份这两个数据和数据结构。备份一个MySQL数据库,您将使用,mysqldump命令:

美元,mysqldump - u df_admin - p——数据库dreamfactory no-create-db > ~ /转储。sql输入密码:

您可以使用MySQL凭证中发现你.env文件来执行备份。如果你的数据库名称dreamfactory然后更新值传递给——数据库相应的行动。的——no-create-db国旗告诉mysqldump命令来生成一个创建数据库命令转储文件。最后,重定向操作符>用于重定向倾倒的输出在其他地方,本例中是一个文件命名dump.sql驻留在执行用户的主目录。请注意这个文件不需要执行mysqldump命令之前就已存在。

一旦完成,一定要复制dump.sql文件到一个安全的地方就像被完成了.env文件。

第三步。准备一个新的主机服务并运行安装程序

早在这一章里,我们提到的自动化安装,包括平台(学习更多在这里]。我们建议下载一个安装程序的DreamFactory库在前文所述的方式和运行它们。目前四个操作系统的支持,包括CentOS, Debian, Fedora, Ubuntu。理想情况下,操作系统将新安装,确保服务器是免费行李。

在安装程序的结论会提示创建第一个管理账户。创建一个,但是我们很快就会导入现有的管理员(s)从生产DreamFactory实例最终新的帐户不会举行任何重要性。万博max手机网页登录

第四步。禁用MySQL的严格模式设置

如果你的生产Dr万博max手机网页登录eamFactory实例系统使用MySQL数据库,那么您可能需要禁用一些称为严格模式在新的MySQL数据库。这是因为MySQL 5.7改变了MySQL的行为在某些情况下,如是否0000-00-00可以被视为一个有效的日期。因此如果你生产MySQL 5.6或更万博max手机网页登录早版本,那么你就几乎肯定需要禁用严格模式。幸运的是,这很容易通过导航到你的新开放DreamFactory实例的根目录配置/ database.php使用文本编辑器如纳米或Vim。向下滚动到mysql数组和添加这个键/值对:

“严格”= >假

步骤# 5。导入系统数据库备份

接下来,我们将从你当前的生产环境中导入MySQL数据库备份到新安装的DreamFactory环境。万博max手机网页登录在这样做之前,我们首先需要删除的内容(模式和数据)新系统数据库。为此,导航到您的新DreamFactory安装的根目录,并运行这些命令:

美元美元php工匠迁移:新鲜php工匠迁移:重置

接下来,备份导入新数据库。回想一下,这个备份中发现的dump.sql文件。文件转移到新的DreamFactory实例,运行这个命令:

美元mysql - u db_user - p dreamfactory_db <转储。sql输入密码:

你需要替换db_user和dreamfactory_db与数据库的用户名和密码你提供安装程序。接下来,我们将运行迁移命令,确保系统数据库包含所有最新的表结构和种子数据:

美元php工匠迁移——种子

最后,清除缓存:

美元php工匠缓存:明确的php工匠美元配置:清楚

恭喜,您已经成功升级DreamFactory实例!导航到指定的域,并登录使用管理凭证与你的旧实例相关联。

结论

DreamFactory安装和配置,它是构建第一个API的时候了!在下一章我们会做到底,走过所需的步骤生成一个基于数据库的API。

API的一代知识库

API生成知识库

文档

26日文章

安装和配置DreamFactory