YOURLS 安装和配置指南

YOURLS 安装和配置指南

YOURLS 🔗 The de facto standard self hosted URL shortener in PHP 项目地址: https://gitcode.com/gh_mirrors/yo/YOURLS

1. 项目基础介绍和主要编程语言

项目基础介绍

YOURLS（Your Own URL Shortener）是一个开源的PHP脚本集合，允许你在自己的服务器上运行一个URL缩短服务。通过YOURLS，你可以完全控制你的数据，包括详细的统计数据、分析、插件扩展等。YOURLS是自托管的URL缩短器的事实标准，广泛应用于需要自定义URL缩短服务的场景。

主要编程语言

YOURLS主要使用PHP编程语言开发，同时也包含少量的JavaScript、CSS和HTML代码。

2. 项目使用的关键技术和框架

关键技术

• PHP: 作为后端语言，处理URL缩短、重定向和数据存储等核心功能。
• MySQL/MariaDB: 用于存储URL映射、统计数据和其他配置信息。
• JavaScript: 用于前端交互和动态内容加载。
• HTML/CSS: 用于构建用户界面和样式。

框架

YOURLS本身是一个独立的PHP项目，没有依赖于其他PHP框架。它提供了灵活的插件机制，允许开发者扩展其功能。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装YOURLS之前，请确保你的服务器满足以下要求：

• Web服务器：如Apache或Nginx。
• PHP：版本5.6或更高。
• 数据库：MySQL或MariaDB。
• 文件权限：确保Web服务器用户对YOURLS目录有读写权限。

详细安装步骤

步骤1：下载YOURLS

你可以通过以下方式下载YOURLS：

git clone https://github.com/YOURLS/YOURLS.git

或者直接下载最新版本的ZIP文件：

wget https://github.com/YOURLS/YOURLS/archive/master.zip
unzip master.zip

步骤2：配置数据库

1. 创建一个新的MySQL数据库，例如yourls。
2. 创建一个数据库用户，并授予该用户对新创建数据库的访问权限。

步骤3：配置YOURLS

1. 进入YOURLS目录，复制user/config-sample.php到user/config.php。
2. 编辑user/config.php文件，配置数据库连接信息：

define( 'YOURLS_DB_USER', 'your_db_user' );
define( 'YOURLS_DB_PASS', 'your_db_password' );
define( 'YOURLS_DB_NAME', 'yourls' );
define( 'YOURLS_DB_HOST', 'localhost' );
define( 'YOURLS_DB_PREFIX', 'yourls_' );

3. 配置站点URL和其他选项：

define( 'YOURLS_SITE', 'http://your-own-domain-here.com' );
define( 'YOURLS_HOURS_OFFSET', 0 );
define( 'YOURLS_UNIQUE_URLS', true );
define( 'YOURLS_PRIVATE', true );
define( 'YOURLS_COOKIEKEY', 'random_cookie_key' );

步骤4：安装YOURLS

1. 将YOURLS目录上传到你的Web服务器的根目录或子目录。
2. 访问你的YOURLS站点URL，例如http://your-own-domain-here.com/admin/。
3. 按照屏幕上的指示完成安装过程。

步骤5：配置Web服务器

如果你使用的是Apache，确保启用了.htaccess文件支持。如果你使用的是Nginx，请参考YOURLS文档配置Nginx重写规则。

步骤6：登录和管理

安装完成后，你可以使用在user/config.php中配置的管理员用户名和密码登录YOURLS管理界面，开始创建和管理短链接。

通过以上步骤，你已经成功安装并配置了YOURLS，可以开始使用它来缩短和管理URL了。

YOURLS 🔗 The de facto standard self hosted URL shortener in PHP 项目地址: https://gitcode.com/gh_mirrors/yo/YOURLS