安装CivicCRM(独立)
Beta版本
CiviCRM Standalone目前处于测试版。
我们鼓励进行测试,非常感谢您帮助识别问题。拜托使用comp:Standalone标记添加在主问题跟踪器上发现的问题.
活动站点尚不支持独立。
关于本文档
本指南涵盖CiviCRM单机版的安装(无父CMS)。它假设您以前审查了CiviCRM要求.
步骤1。选择安装方法
目前有四种安装CiviCRM Standalone的方法。
选项1。下载发布tarball-大多数网站
这是大多数常规站点的推荐安装方法。本页其余部分假设您以这种方式安装。
选项2。使用作曲家-复杂网站
使用composer可以更加自动化地管理站点安装和包。它在某些情况下可能很有用,例如自动部署。它需要shell访问不如果您是CiviCRM新手,建议您使用。
选项3。为开发人员使用CiviCRM Buildkit
如果您是CiviCRM Core的开发者,建议使用CivilCRM构建工具包创建独立站点。主站点模板称为标准清洁剂
。作曲家风格的替代方案称为独立编译器
.
建议仅在测试站点使用Buildkit。如果您希望在未来的生产中运行CiviCRM Standalone,您应该遵循选项1或2。
选项4。使用git下载-不推荐
您还可以通过直接克隆git repo来安装CiviCRM Standalone。通常不建议这样做——如果您需要git,那么使用Buildkit可能会更容易。
选项5。使用Docker-新增
有一个新项目要为CiviCRM Standalone创建Docker映像。如果您以前使用过Docker,这是一种快速启动和运行的方法。您可以查看项目进度并找到安装说明论项目回购
有关Buildkit,请参见链接的Buildkit文档。
对于composer或git安装,请参阅Standalone Alternative Install Methods(TODO公司).
对于Docker,请参阅链接的存储库。
本页其余部分假设您是从发布tarball(选项1)进行安装。
步骤2。下载版本
下一步是获取CiviCRM代码。您可以选择要安装的版本。
本月发布
最新的每月发布版本可从主发布页面.
由于Standalone仍处于测试阶段,与下一个候选版本(RC)相比,运行本月的版本没有多大优势。
下载本月的版本
下个月发布
下个月的版本可从下载最新版本页面.
选择结束选项*-RC-标准
然后下载。
测试RC将有助于提高下个月版本的稳定性。
下载下个月的版本
出血边缘夜间构建
你也可以从下载当晚的版本最新版本页面.
选择结束选项*-夜间独立
然后下载。
这是可用的最新版本,但请注意,可能有错误!🐛
下载昨晚的发布
步骤3。将代码部署到web服务器/宿主
该版本包含压缩文件中站点的所有代码。
在此步骤中,您需要提取代码并将其传输到web服务器。
如果您正在使用网络托管,您可以上传压缩文件,然后解压缩,或者在您的计算机上解压缩,然后上传解压缩的文件。这在一定程度上取决于您的主机配置。
关键是维护发布存档中的文件夹结构。主文件夹应至少包含civicrm.standalone.php公司
文件,以及核心
,公众的
和私有的
子文件夹。
您需要确保此文件夹位于Web服务器可以指向它的位置。记下此文件夹的路径(例如。/var/www/example.org
或/mywebhost/user123124019231/sites/civicrm
),稍后您会需要它。
注意:您应该将域或子域直接指向独立项目根目录。安装到URL子目录(例如。https://mysite.com/projects/standalone)当前不支持。
更多详细信息:CiviCRM独立文件夹结构
独立站点应该有一个主文件夹,在独立中称为“项目根”.
系统完全安装和使用后,该文件夹的内容如下所示:
文件/文件夹 |
目录 |
civicrm.standalone.php公司 |
独立引导文件。这将标识独立项目根目录,并标识CiviCRM代码和设置文件的位置。 |
堆芯,堆芯/ |
CiviCRM的核心源代码 |
私人/ |
不应通过web访问的专用站点文件 |
私人/civicrm.settings.php |
CiviCRM低级别设置的配置文件。 |
私有/日志/ |
日志文件 |
私有/缓存/ |
CiviCRM模板编译器的缓存文件 |
私人/l10n/ |
翻译文件 |
私人/附件/ |
上传到CiviCRM网站的私人文件-例如上传到特定联系人的文件 |
公众/ |
公共站点文件应该可以通过网络访问 |
公众/媒体/ |
上传到您站点的公共文件,如出现在贡献页面或群发电子邮件中的图像 |
公共/ang/ |
角度模板-例如,用于使用FormBuilder添加到站点的自定义表单 |
扩展名/ |
您已添加到站点的CiviCRM扩展 |
步骤4。如果需要,获取翻译
默认CiviCRM语言为美国英语(en_US(_US)
). 您可以在web安装步骤中选择不同的语言或区域设置,所选的翻译将为您下载。你现在不需要做任何事情。
或者,如果您需要其他语言的web安装程序,您可以现在手动下载所有翻译文件。
前往https://civicrm.org/下载并从下载下拉列表中选择“国际化文件”,然后将其解压缩到您的核心
目录。解压缩的文件应该以芯/l10n
和核心/sql
.
步骤5。配置MySQL
CivicCRM将数据存储在MySQL(或者,相当于MariaDB)中。您需要提供一个新数据库并确定关键详细信息:
- MySQL主机名/IP(以及端口号(可选))
- MySQL数据库名称
- MySQL用户名
- MySQL密码
MySQL数据库:在网络主机上设置新数据库
如果您使用的是Web主机,它们通常会为此提供UI,您可以从中获取这些详细信息。
或者,他们可以提供phpmyadmin公司或面板访问数据库服务器。您可以在线找到这些工具的指南,例如。https://phppot.com/mysql/phpmyadmin-create-database网站/或https://support.cpanel.net/hc/en-us/articles/360057550753-How-to-create-a-database-and-database-user-in-cpanel
MySQL数据库:通过命令行创建数据库
打开mysql(mysql)
命令行界面。您可能需要运行以下命令之一:
mysql(mysql)mysql-u根mysql-u根-pmysql-u root-p--主机=db.example.com--端口=3306
这将显示欢迎消息:
欢迎使用MySQL监视器。命令以以下字符结尾:;或\g。您的MySQL连接id是6879服务器版本:8.0.29源分发版权所有(c)2000、2022、Oracle和/或其附属公司。Oracle是Oracle Corporation和/或其附属公司。其他名称可能是其各自的商标业主。键入“help;”或“\h”以获取帮助。键入“\c”清除当前输入语句。mysql>
现在,您可以配置数据库(公民
),用户(公民
)、和密码(__顶部_护圈__
):
mysql(mysql)> 创建 数据库 民用客户关系管理 字符 SET(设置) 800万桶外4 COLLATE公司 utf8mb4_unicode接口;
查询 好 啊, 1 行 影响 (0.00 秒)
mysql(mysql)> 创建 用户 “公民”@“本地主机” 已确定 由 '__TOP_SECRET__';
查询 好 啊, 0 排 影响 (0.01 秒)
mysql(mysql)> 格兰特 所有 在 公民.* 到 “公民”@“本地主机”;
查询 好 啊, 0 排 影响 (0.01 秒)
步骤6。配置Web服务器
现在,您需要配置Web服务器以指向CiviCRM独立项目文件夹。
具体步骤因具体环境而异。以下是常见环境的一些典型任务:
Web托管:将新子域指向独立项目文件夹
如果您正在使用网络托管,并且您的发布代码位于例如。/mywebhost/user123/my-sites/civicrm
,则只需将托管中的域或子域指向此目录即可。
您需要确保启用了PHP,包括安装要求中详细介绍的PHP模块。您的web主机可能提供UI,或者您可能需要添加php.ini公司
文件指定选项。
您应该指定私有的
文件夹应不可以通过网络访问。
阿帕奇:在基于Debian的服务器上配置虚拟主机
如果您创建的文件夹类似于/var/www/example.com/web
,则可能需要配置web服务器来读取此文件夹。
其本质是在下面创建一个配置文件/etc/apache2/站点-*
用一个<虚拟主机>
声明,例如:
<虚拟主机*:80>服务器管理员me@example.comDocumentRoot/var/www/example.com/web服务器名称example.com...</VirtualHost>
有关完整示例,请参阅为Drupal站点安装虚拟主机(此示例适用于Drupal,但类似的步骤也适用于CiviCRM Standalone-只需调整网站根目录
和服务器名称
.)
nginx公司:在基于Debian的服务器上配置虚拟主机
(*示例nginx虚拟主机配置正在进行中-检查https://github.com/civicrm/civicrm-standalone更新-欢迎贡献!*)
第7步。配置Web服务器权限
您的Web服务器至少需要能够写入您的公众的
和私有的
目录。如果您希望通过站点上的web UI安装扩展,web服务器还需要向提取
目录。
在许多Web主机上,Web服务器将能够写入所有目录,您无需执行任何操作。
如果你有ssh标准
访问服务器时,可能需要直接设置用户权限。
权限:授予对的写入权限公众的
,私有的
和提取
Linux服务器上的目录
在大多数Linux发行版中,web服务器与一个特殊的用户+组(例如www数据
或网址:www
).
您必须专门授予此用户写入数据文件夹的访问权限。通常,您希望授予组访问权限www数据
到私有的
,公众的
和提取
文件夹。
光盘/var/www/example.com/webchmod公司2770私有公共分机chmod g+rwX-R专用公共文本chgrp-R www-data私有公共分机
第8步。运行安装程序
安装程序验证需求,准备数据库,并初始化配置文件。您可以通过web界面运行安装程序(哪个更简单)或命令行界面(有更多选择).
通过web UI运行安装程序
- 前往
/公民
页面。这可能看起来像:
https://example.com/civicrm
http://localhost:8000/civicrm(本地主机)
http://example.12.0.0.0.1.nip.io:8001/civicrm示例
- CiviCRM安装程序将打开。
- 您需要提供之前创建的数据库的详细信息
- 您还必须为站点管理员用户提供用户名、密码和电子邮件地址。注意:此登录与步骤1中的数据库用户名和密码完全不同。
- 如果有未满足的要求,安装程序将列出它们。请咨询要求其他建议的文档。
- 如果满足所有要求,继续调查问卷。
- 如果您希望CivicCRM以另一种语言安装,然后是英语-美国,则可以选择另一种语言。安装程序将为您下载翻译文件。
- 最后,单击“安装CiviCRM”。
- 安装后,您应该会看到一个确认页面,确认安装已正确完成。
通过命令行运行安装程序
CiviCRM有一个命令行管理工具,简历
,可以执行安装。对于本地开发站点,典型的安装命令可能是:
光盘/路径/目标/标准服务目录cv核心:安装-v\--cms-base-url=http://localhost:8000\--数据库=mysql://用户:通过@主机:端口/数据库\-m个extras.adminUser=用户名\-m额外.adminPass=秘密\-m extras.admin电子邮件=ME@EXAMPLE.COM公司
有关详细信息,请参阅命令行安装程序.
安装程序将验证您是否下载了CiviCRM的正确版本,并检查您的服务器环境以确保其符合CiviCRM要求。然后,它将为CiviCRM创建和填充一个数据库,并创建您的CiviCRM设置文件(CiviCRM.settings.php)。
登录并查看用户和权限
现在您应该可以登录到您的站点,例如。https://your-site.test/civicrm/login
。使用安装期间创建的管理员用户名和密码。
前往管理员>>用户和权限配置站点的用户和角色。
检查检查表
这个配置清单提供了一种方便的方式来完成需要为新站点查看和配置的设置。您可以从安装成功页面链接到此清单,您可以随时从管理»管理控制台»配置清单.
测试驱动的CiviCRM
开始探索您的新CiviCRM独立网站。请报告您在问题跟踪程序中发现的任何问题:https://lab.civicrm.org/dev/core/-issues/?label_name%5B%5D=comp%3A独立
附录
故障排除
- 查看故障排除页面以获取有关安装过程中可能遇到的问题的帮助。