目录
技术要求
要运行 Linguise 翻译脚本，您’需要以下内容：
- 运行 PHP 7+ 和 Laravel
- Apache、LiteSpeed、NGINX、IIS 服务器
- 在服务器配置中激活 URL 重写
- Laravel’s root folder typically set on “public” folder, make sure to install Linguise within this folder
1. 生成 API 密钥
在您连接到您的 Linguise dashboard 您需要先设置一个新域名并保存其设置以获取 API 密钥。
API 密钥是激活您网站翻译所必需的。基本上，API 密钥会检查哪个语言在何种域名上被激活，并允许生成神经翻译页面。.
复制 API 密钥并将其保存到剪贴板中。.
然后点击标签 “Script PHP”，您将获得我们将在此详细遵循的安装说明。.
2. 上传并连接 Linguise 翻译脚本
Linguise 翻译脚本需要上传到您的服务器，在 Laravel 安装的文件夹中，可以在此处下载：
脚本下载后，解压并上传到 Laravel 安装的根文件夹。.
- 确保它’在 根级别 您的 Laravel 安装的 (通常 Laravel 将根设置在 “public” 文件夹，您可以在此安装 Linguise)
- 确保文件夹 被命名为 “linguise”（文件夹解压后默认的名称）
如何访问 Linguise 脚本界面？
完成 Linguise 安装后，您可以通过以下 URL 格式访问您的网站仪表板：
https://www.domain.com/linguise
根据您网站的地址更改域名地址*
确保 Linguise 拥有适当的读写权限*
设置密码和数据库连接
一旦您访问脚本界面，系统将呈现一个设置屏幕，您可以在此创建密码并连接到您偏好的数据库。.
您可以：
- 设置密码，未来访问此界面时将需要该密码。.
- 选择您的数据库类型——可以是 MySQL 或 SQLite，取决于您的设置和偏好。.
此初始设置确保安全访问，并允许您根据环境配置脚本。.
MySQL 数据库连接
如果您选择 MySQL，将出现一个不同的界面，要求填写以下 MySQL 配置字段的连接详细信息：
确保信息正确，以成功连接到您的 MySQL 数据库。.
MySQL 与 SQLite – 有何区别？
MySQL 和 SQLite 都是流行的数据库系统，用于存储和管理网站及应用程序的数据。然而，它们针对不同的使用场景设计，并且存在一些关键差异：
| 特性 | SQLite | MySQL |
|---|---|---|
| 设置 | 非常容易（需要安装 SQLite） | 需要服务器设置 |
| 存储 | 单文件 | 由 MySQL 服务器管理 |
| 性能 | 非常适合小规模应用 | 更适合大型高流量系统 |
| 使用场景 | 本地应用、测试、小型站点 | Web 应用、电子商务、企业系统 |
Linguise 脚本接口：PHP 平台设置
Linguise 翻译仪表板，之前仅适用于 Joomla 和 WordPress，现在已扩展对 PHP 及其他平台的支持。此更新允许用户从统一界面无缝配置语言设置—例如显示选项、旗帜样式和外观自定义—，无论其 CMS 或框架为何。.
管理员可以更高效地管理 Linguise 设置，具备一致的功能，如语言选择弹窗、阴影效果以及地区特定的旗帜选项变体。仪表板保持用户友好的设计，同时为多样的网络环境提供更广泛的兼容性。.
3. 设置语言 URL
按语言划分的 URL 需要在 .htaccess 文件中进行配置，如果您有一个 “RewriteBase /” 在您的文件中，只需在其后复制以下所有代码:
<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^linguise/linguise.php$ - [L] RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA] </IfModule>
4. 在 Laravel 上激活语言切换器
语言切换器是用于选择所需语言的旗帜弹出窗口。要加载它，您需要复制网站配置末尾（Linguise 仪表板）提供的代码。.
该脚本必须加载在 Laravel 处理的 HTML 页面头部。随后旗帜语言切换器将自动加载。.
语言切换器默认会显示在您网站右上角的悬浮位置。欢迎您使用 CSS 按需自定义它。.
SEO重要提示： 您设置的语言数量对SEO有很大影响。当您设置翻译语言时，如果有大量已索引的页面（>500），搜索引擎可能需要很长时间来处理它们。这可能会影响您原始语言的SEO。因此我们建议您一开始最多添加5种语言，等它们被索引后，您可以每月批量添加3种语言。
设置语言切换器
可以在 Linguise 仪表板 > 设置 > 语言旗帜显示 中自定义语言切换器。此处的每一次修改都会在网站上体现。.
屏幕右侧是语言切换器的预览。您可以设置以下元素：
- 三种布局：并排、下拉菜单或弹出式
- 语言切换员职位
- 语言切换器内容
- 英语或母语中的语言名称
- 旗帜的形状和尺寸
- 颜色和阴影
在 Laravel 内容中加载语言切换器
要在 Laravel 内容的特定位置显示语言切换器，您应将位置设置为 “In place”。
在 Linguise 仪表板中设置位置后，您可以添加以下短代码以包含它。点击下面的代码将其复制到剪贴板。
<div>[linguise]</div>
添加完成后，前端会在您添加代码的 HTML 区域中显示国旗和语言名称。.
Laravel 页面本地缓存系统
作为一种选项，您可以激活本地缓存系统，该系统存储 URL 及其相关的多语言内容，以加快页面加载速度。本地缓存将减少 Linguise 服务器与您网站服务器之间的数据传输。仅在页面已翻译且未更新时才使用缓存。优先保留的缓存将是访问量最高的多语言页面的缓存。.
作为选项，您可以定义以 MB 为单位的缓存容量。在下面的示例中，缓存已启用，需保留的缓存容量为 500MB：
/** 基本配置 **/ public $cache_enabled = true; public $cache_max_size = 500; // 以兆字节为单位
Laravel 平台的特定设置
在 Configuration.php 文件中，我们还有一个设置，允许为 CMS 或非 CMS 传递一些特定的配置。 默认情况下，它是自动的，但支持团队可能会要求您个性化它以使用一些特殊设置。
以下是要为 Laravel 添加的代码， 这是小写的 CMS 名称：
/** 基本配置 **/ /* * 根据您的 CMS 更新 CMS 值 * 可用的 CMS 有：laravel，prestashop */ public static $cms = 'laravel';
从 SQLite 到 MySQL
仍然在 Configuration.php there’s 一个设置可以强制使用 MySQL 而不是 SQLite，以防服务器上未安装 SQLite。.
在这种情况下，您’ll 需要填写 MySQL 信息 此部分的 Configuration.php 文件：
/** 高级数据库配置 **/ /* * 如果您不想使用 Sqlite，您可以使用 MySQL * 为此，您需要填写以下变量 * Linguise 将为您创建表 */ public static $db_host = ''; public static $db_user = ''; public static $db_password = ''; public static $db_name = ''; public static $db_prefix = '';
Laravel + Windows IIS 服务器上的自动翻译
在您的 Web.config 文件中添加对应于您网站构建器的行。
它应在任何其他重定向之前设置，尤其是重定向到您的 PHP 主文件：
<rule name="Linguise" stopProcessing="true"> <match url="^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$" ignoreCase="false" /> <conditions logicalGrouping="MatchAll" trackAllCaptures="false" /> <action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" /> </rule>
Laravel + NGINX 服务器上的自动翻译
rewrite ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 last;