简介面向需要自建短链服务的开发者、站长或运维人员这款黑色简洁风格的 PHP 短网址生成源码可部署在自己的服务器上避开第三方短链平台在域名、隐私或统计功能上的限制实现数据与广告位后台自主管理。前端支持创建普通/自定义短链、密码保护、链接统计、暗色主题和书签脚本并集成复制、分享操作后端可删除网址、编辑站点设置、添加/编辑广告、分析访问数据也可注入自定义 CSS 调整界面适合个人工具站、博客外链或企业内链中转。压缩包为 RAR 格式共 103 个文件核心为 34 个 PHP 文件与 11 个 JS、10 个 CSS另有 scss/less 预处理样式、字体文件和 2 个 SQL 数据库脚本整体约 681KB轻量易部署前端基于 Bootstrap、Font Awesome 等常用样式库响应式设计在移动端也能获得一致体验。已有 212 人学习下载整套源码目录结构清晰可快速完成安装与二次开发既能直接当作短链接工具使用也能从中借鉴 PHP 链接管理、统计分析和暗色主题的实现思路。1. 一个 .rar 里装的到底是什么PHP 短网址源码没那么玄乎收到“黑色简洁的PHP短网址短链接生成源码.rar”这种包第一反应别急着解压。这类源码在二手源码站上很常见黑色简洁说的是 UI 层用了深色主题PHP 是后端语言短网址是它要解决的核心问题。说直白点短网址服务就是一张“短码到长链接”的映射表生成短码、存下来、访问时跳转。这套源码的价值不在黑底色 UI而在于把“不依赖第三方平台、数据在自己手里”的能力做齐了。短视频外链被拦截、短信里塞不下长 URL、二维码容错率不够这些场景都需要一个能自己部署的短网址系统。适合谁手上有 PHP 虚拟主机或小服务器的个人站长想给内部系统做短链服务的人以及想完整跑通一个 PHP 项目结构的新手。这篇文章就按这个方向把这套源码从原理到部署、从参数到排查拆开讲。2. 短网址系统的核心逻辑短码生成、重定向与状态码选择2.1 短码就是主键映射表才是本体很多人第一次看短网址源码都会去找“压缩算法”找半天发现根本没有。短网址不是压缩长链接并没有被压短它只是一条记录的主键。你拿到一串“https://d.com/Ab3x9”真正起作用的是 Ab3x9 这个短码服务端用它在数据库里查到对应的长链接然后发一个重定向头让浏览器跳过去。最小可用系统就三个动作接收长 URL → 生成短码 → 落库访问时取短码 → 查库 → 跳转。整个链路没有黑匣子任何一个 PHP 开发者都能写难的是把短码撞库、伪静态路由、状态码缓存这些边角处理干净。这套源码如果结构完整你应该能在里面看到四个东西入口路由、短码生成函数、数据库操作类和一个深色后台页面。2.2 短码生成随机短码与自增转进制两条路短码生成算法决定了一个短网址服务的容量和安全性。常见的 PHP 实现有两条路一是随机短码用 random_bytes 取随机字节再转成字母数字二是自增 ID 转 62 进制把数据库主键转成短码。随机短码的好处是外部无法枚举别人猜不出你下一个短码是什么适合对外公开的服务。自增转 base62 的好处是无碰撞、生成速度快但短码按顺序排列容易被遍历抓取适合内部系统或登录后才能用的场景。我见过的同类 PHP 短网址包里随机短码占多数因为部署简单不需要维护自增序列。?php // 随机短码random_bytes 是 PHP 7.0 引入的密码学安全随机源 function generate_short_code(int $length 6): string { $bytes random_bytes(6); // 取 6 字节随机数 $hex bin2hex($bytes); // 转成十六进制字符串 // 截断到目标长度短码只保留字母数字避免特殊字符进 URL return substr($hex, 0, $length); }这段代码逻辑很直接random_bytes 生成 6 字节随机数bin2hex 转成 12 位十六进制串再截前 6 位。参数 length 控制短码长度调成 4 就是 4 位短码调成 8 就是 8 位。注意 random_bytes 在 PHP 7.0 才有如果你要部署的环境还是 PHP 5.x这一段直接报错后面避坑章节会细说。自增转 base62 的写法长一点但思路更传统?php // 自增 ID 转 62 进制短码无碰撞但可枚举 const SHORT_CHARS 0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ; function id_to_short(int $id): string { $code ; $base strlen(SHORT_CHARS); // 62 while ($id 0) { $code SHORT_CHARS[$id % $base] . $code; $id intdiv($id, $base); } return $code ! ? $code : SHORT_CHARS[0]; }这套逻辑把主键按 62 进制一位一位拆出来映射到数字、小写字母、大写字母上。十万条数据只要 3 位短码就装得下百万条也只要 4 位。代价是短码有规律别人能顺着你的短码扫出全站链接。所以对外服务我一般不用这条路对内系统用它很舒服。2.3 跳转实现301 与 302 的选择是个坑短码生成只是前半场真正决定用户体验的是跳转那一行代码。PHP 里最朴素的写法就是?php // 短码跳转统一用 302方便后续改目标地址和统计 require_once __DIR__ . /db.php; $code $_GET[code] ?? ; if ($code ) { http_response_code(400); exit(缺少短码); } $target find_url_by_code($code); if (!$target) { http_response_code(404); exit(短链接不存在或已过期); } header(Location: . $target, true, 302); exit;这里唯一需要纠结的是状态码选 301 还是 302。301 是永久重定向浏览器和搜索引擎会缓存这个结果当你改了长链接目标地址老用户访问短码可能还是跳到旧地址——这是短网址系统最常见的翻车点。302 是临时重定向每次请求都回服务器查一次库跳转目标随时能改点击次数也能准确统计。所以做短网址服务我不管源码里默认写的什么一律改成 302。只有一种情况例外你确定某个短码对应的长链接永远不变又想省服务器压力才用 301。另外注意 header() 之后必须 exit否则 PHP 脚本继续往下执行可能输出多余内容污染响应。2.4 存储层选型MySQL 还是 SQLite去查这套源码的数据库配置文件你会发现有两种写法一种连 MySQL一种用 SQLite。选哪个不取决于源码取决于你的部署环境。存储方式适用场景并发上限部署复杂度SQLite虚拟主机、个人小站、日请求几百次几百 QPS 内零配置文件即库MySQL独立服务器、对外开放服务高并发无压力需要建库建用户如果你只有一台虚拟主机没有 phpMyAdmin 权限SQLite 是唯一靠谱的路。PDO 封装的好处就在这切换数据库只需要改 DSN 一行配置sqlite:/path/to/db.sqlite 改成 mysql:hostlocalhost;dbnameshorturl。前提是源码里的 SQL 语句没用到 MySQL 独有语法比如 ENGINEInnoDB 这种建表语句在 SQLite 里就得删掉。后面部署章节会给一套两边都能跑的表结构。3. 把黑色简洁的短网址源码跑起来环境、路由与最小部署3.1 环境要求PHP 版本与扩展两个前提解压 .rar 之后第一步不是改代码是确认环境。PHP 短网址源码最怕遇到老版本虚拟主机PHP 5.2、5.3 还在服役的并不少见。需要满足两个前提PHP 7.4 以上版本以及 pdo、pdo_mysql 或 pdo_sqlite 扩展。判断方法很直接php -v php -m | grep -i pdo第一行看版本号第二行看 PDO 扩展装没装。如果输出里一个 pdo 都没有这个源码基本跑不起来因为短网址系统的数据库操作层就是用 PDO 写的。顺手再看一下 openssl、json 扩展PHP 5.6 以后的默认发行版基本都带但有些精简版虚拟主机会缺。环境不对后面全是白费功夫这一步别跳。3.2 伪静态路由Apache 与 Nginx 两条配置短网址系统对路由有一个硬性要求用户访问 /Ab3x9 时服务器要把 Ab3x9 当成参数传给 PHP 脚本。这就是伪静态Nginx 下叫 rewriteApache 下叫 .htaccess。Apache 的配置通常写在网站根目录的 .htaccessRewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?code$1 [QSA,L]这段规则的意思是如果请求的不是真实文件也不是真实目录就把整条路径交给 index.phpcode 参数就是短码。QSA 表示保留原有 query stringL 表示这是最后一条规则。习惯用 Apache 的虚拟主机一般都已经开启 mod_rewrite如果 404去查一下是否 AllowOverride All。Nginx 下没有 .htaccess要改站点配置文件location / { try_files $uri $uri/ /index.php?$query_string; }try_files 的意思是先找真实文件再找真实目录都找不到就把请求交给 /index.php同时把原始 query string 带上。这两条配置的效果一样但很多人在 Nginx 里图省事写成 rewrite ^(.*)$ /index.php last;少了 query string短码参数就丢了访问 http://yourdomain.com/Ab3x9 直接 404手动访问 index.php?codeAb3x9 却正常。这个现象是短网址部署的头号坑排查章节还会重点说。3.3 安装三步检查入口文件与建表放下源码包后我一般按三步走确认环境、建库建表、改配置。第一步前面说过了第二步是把数据库结构建出来。这套建表语句兼容 MySQL 和 SQLite 的常见用法CREATE TABLE IF NOT EXISTS short_urls ( id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY, short_code VARCHAR(16) NOT NULL UNIQUE, long_url TEXT NOT NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, expires_at DATETIME NULL, hits INT UNSIGNED NOT NULL DEFAULT 0, INDEX idx_expires (expires_at) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;short_code 加唯一索引是关键这是防撞码的最后一道防线。假如生成逻辑有 bug两条相同短码插进表里唯一索引会直接报错拦住而不是让后一条覆盖前一条。expires_at 默认 NULL 表示不过期按业务需要再填时间。SQLite 下把 ENGINEInnoDB 那句去掉就行其它语法通用。第三步是改配置文件里的数据库连接常见做法是单独一个 config.php?php // 数据库连接配置SQLite 与 MySQL 二选一 define(DB_TYPE, sqlite); // sqlite 或 mysql define(SQLITE_PATH, __DIR__ . /data/shorturl.db); define(DB_HOST, localhost); // MySQL 专用 define(DB_NAME, shorturl); // MySQL 专用 define(DB_USER, root); // MySQL 专用 define(DB_PASS, your_password); // MySQL 专用把 DB_TYPE 改成 sqlite程序就会走 SQLite 连接改成 mysql就用后面四项连 MySQL。数据库连接类里的 DSN 一般会根据这个常量拼出来不要自己去改连接代码改配置即可。提示上传到虚拟主机后如果页面空白先看 PHP 错误日志路径通常在 /logs/php_error.log 或 web 目录下的 error_log。这一步能区分是语法错误还是数据库连接失败。4. 三个必调参数与数据结构设计短码长度、冲突重试与过期策略4.1 短码长度与字符集怎么定源码默认的短码长度可能很短上线前一定要自己算一笔账。短码用的字符集通常是 62 个字符数字 10 个、小写字母 26 个、大写字母 26 个短码长度组合数实际容量评估建议4 位62^4 ≈ 1470 万十万条内可用过百万开始吃紧不推荐5 位62^5 ≈ 9.1 亿千万条级别无压力可接受6 位62^6 ≈ 568 亿亿级业务都够推荐我一般默认 6 位理由不是容量不够而是 4 位短码在亿级组合下依然能被暴力枚举攻击者可以从 aaaa 一路试到 zzzz把所有短码扫一遍。6 位组合数足够大扫描成本高同时 URL 又不至于太长。字符集也有讲究。62 个字符里有几组长得像的数字 0 和字母 O、数字 1 和字母 l 和字母 I。用户收到短码后是肉眼复制遇到 oO0 混在一起就很容易输错。如果不介意损失一点容量我建议字符集去掉这几个易混字符62 个字母数字收成 58 个换来的是用户报错率明显下降。4.2 冲突重试唯一索引才是底线短码生成再随机也有撞库的可能。两套独立进程同时生成同一个短码数据库里只能留一条。源码里如果有“先 SELECT 查重再 INSERT”这种写法趁早改掉因为两个请求可能同时查不到又同时插入查重形同虚设。正确做法是直接把 INSERT 丢给数据库靠唯一索引报错来感知冲突?php // 带冲突重试的插入依赖 short_code 的唯一索引兜底 function insert_short_url(string $code, string $long_url, ?string $expires_at null): bool { global $pdo; for ($attempt 0; $attempt 3; $attempt) { try { $stmt $pdo-prepare( INSERT INTO short_urls (short_code, long_url, expires_at) VALUES (?, ?, ?) ); $stmt-execute([$code, $long_url, $expires_at]); return true; } catch (PDOException $e) { // SQLSTATE 23000 是唯一索引冲突 if (strpos($e-getMessage(), 23000) false) { throw $e; } // 撞码了换一个新的短码重试 $code generate_short_code(6); } } return false; }这段代码把重试次数控制在 3 次以内3 次都撞码的概率约等于零。逻辑说明两点一是捕获 PDOException 后要判断是不是 23000数据库连接挂了也走这个异常不能盲目重试二是撞码后重新调 generate_short_code 生成新码不要用原来的短码加后缀否则短码长度不可控。4.3 过期策略expires_at 与定时清理很多短网址源码没有过期功能短码一旦生成就永久有效。如果你的场景是活动链接、临时分享最好把过期时间用起来否则垃圾短码会越积越多。查询的时候加一个过滤条件过期的不返回SELECT long_url FROM short_urls WHERE short_code ? AND (expires_at IS NULL OR expires_at NOW());注意这里的括号expires_at IS NULL 表示永久有效expires_at NOW() 表示还没过期两个条件用 OR 连接整个组用括号包住避免和 short_code 条件产生优先级问题。清理过期数据用定时任务每天凌晨跑一次0 3 * * * php /var/www/shorturl/cleanup_expired.phpcleanup_expired.php 里就一条 DELETE按 expires_at 把过期数据批量清掉。如果数据量大DELETE 加上 LIMIT 分批删避免一次删几十万行把数据库锁死。4.4 URL 编码的边界中文与已有百分号这节容易被忽略但线上出问题最多的往往在这。用户提交的长链接可能带中文、空格、Emoji直接存库、直接跳转浏览器拿到 Location 头经常解析失败跳过去 404。常见误用是对整个 URL 调 rawurlencode这会把 URL 里已有的合法百分号编码也二次转义比如原始链接里有个 %20rawurlencode 之后变成 %2520跳过去还是一样 404。正确做法是只编码非 ASCII 那一段?php // 只编码非 ASCII 字符保留 URL 里已有的合法转义 function encode_url_for_location(string $url): string { return preg_replace_callback(/[^\x00-\x7F]/, function (array $matches) { return rawurlencode($matches[0]); }, $url); }这段正则把 URL 里的非 ASCII 字节挑出来单独编码ASCII 部分原样保留。入库前也建议用这个函数处理一遍保证数据库里存的是合法 URL 字符串跳转时直接用不要二次编码。5. 短链接系统的常见坑与排查5 条血泪经验5.1 Nginx 下短链接全部 404手动带参数却正常现象访问 http://yourdomain.com/Ab3x9 返回 404访问 http://yourdomain.com/index.php?codeAb3x9 却正常跳转。 原因Nginx 伪静态规则没把短码参数传给 PHP或者 rewrite 规则丢了 query string。 解决用 try_files 而不是裸 rewrite。站点的 location 配置改成location / { try_files $uri $uri/ /index.php?$query_string; }改完记得 nginx -s reload。验证方法是访问任意一个不存在的路径看地址栏有没有变成 index.php?codexxx如果变成说明参数没传过去。反复出现这个问题直接放弃 rewrite用 try_files 一劳永逸。5.2 后台改了目标地址用户还是跳到旧页面现象在后台把某条短码的长链接从 A 改成 B老用户访问短码还是跳到 A。 原因前一个版本用了 301 永久重定向浏览器和搜索引擎已经把它缓存了后续访问不再请求服务器直接走本地缓存。 解决全站统一改用 302。已经发出的 301 短码没办法召回只能生成新短码替换旧链接。排查方法是用 curl -I 访问短码看响应头里的 HTTP 状态码curl -I https://yourdomain.com/Ab3x9如果返回 HTTP/1.1 301 Moved Permanently赶紧改源码里的 header 状态码。这条坑影响的是所有历史短码越早上线越难收拾。5.3 本地运行正常上传虚拟主机后白屏现象Windows 本地 PHP 环境跑得好好的传到虚拟主机后一片空白什么错误都不显示。 原因虚拟主机 PHP 版本偏低源码用了 ?? 运算符、random_bytes、intdiv 这类 PHP 7 才有语法和函数PHP 5.x 直接解析失败加白屏。 解决先 php -v 看虚拟主机版本PHP 7.4 以下就不要挣扎了。如果源码必须兼容老环境把 ?? 改成 isset($_GET[code]) ? $_GET[code] : 把 random_bytes 换成 mt_rand 拼字符串的兼容方案。不过这属于治标能换 PHP 7.4 的环境就换PHP 5 连安全更新都没了。5.4 并发一上来偶尔几条请求返回 500现象日常流量没事一到活动流量进来少量短码创建请求直接报 500。 原因两个请求生成了同一个随机短码同时 INSERT撞了唯一索引异常没有被捕获PHP 直接抛 500。 解决把插入操作包在 try-catch 里捕获 SQLSTATE 23000 后重新生成短码再试一次。第 4.2 节那段代码就是干这个的。排查时打开 PHP 错误日志看到 Duplicate entry for key short_code 就说明撞码了。5.5 带中文参数的链接跳转后 404现象用户提交的长链接带中文查询参数短码访问时跳到一个打不开的地址。 原因Location 响应头里的非 ASCII 字符没有编码浏览器解析时把中文和后面的参数截断了。 解决入库前和跳转前都用第 4.4 节那个 encode_url_for_location 处理只编码非 ASCII 段。千万不能用原始字符串直接拼 URL也不能对整个链接做 rawurlencode。判断标准跳转过去后的地址栏和原始链接逐字符对比有差别就看是哪一段被动了。提示这五条里 5.1、5.2 是环境层面的坑改一次配置就能避免5.3、5.4、5.5 是代码层面的边界问题排查时先看日志别靠肉眼猜。6. 把这些 PHP 短网址能力做厚API 化、统计与自定义短码基础跳转跑通只算完成了 50%剩下 50% 是把短网址真正接进业务。最常用的扩展是 API 化让前端页面通过 AJAX 直接生成短码而不是每次都要进后台?php // api/create.php返回 JSON方便前端调用 header(Content-Type: application/json; charsetutf-8); require_once __DIR__ . /db.php; $long_url $_POST[url] ?? ; if ($long_url || !filter_var($long_url, FILTER_VALIDATE_URL)) { echo json_encode([code 0, msg URL 不合法]); exit; } $code generate_short_code(6); insert_short_url($code, $long_url); echo json_encode([code 1, short_url https://your.domain/ . $code]);filter_var 校验 URL 格式能挡住一半无效输入。返回的 short_url 直接用拼接域名写你自己的不要写死。前端拿到这个 JSON 后把短码渲染成二维码或复制按钮。统计功能也不难跳转命中时把 hits 字段累加就行UPDATE short_urls SET hits hits 1 WHERE short_code ?;要按天统计就在短码表之外再建一张访问日志表记录访问时间、来源 IP、User-Agent定时任务归档。自定义短码是用户很喜欢的一个功能生成短码时接收一个 code 参数先查重没用过就直接用。这就把短码从随机串变成了品牌词比如 https://your.domain/vip 比 https://your.domain/k2Jd8x 清晰得多。至于黑色简洁的界面通常是用 CSS 变量集中管理主题色背景色、卡片色、强调色各自定义在 :root 里换肤只改几个变量不动业务代码。很多深色 UI 的 PHP 后台都是这个套路也是这套源码“黑色简洁”四个字落到代码里的位置。我上线短链接服务前有个习惯先用 curl 把状态码检查一遍再把短码长度改成 6 位最后把 Nginx 的 try_files 抄进配置这三步能挡住短网址系统八成日常问题。希望帮到你。本文还有配套的精品资源点击获取
PHP短网址源码解析：从短码生成到部署避坑指南
简介面向需要自建短链服务的开发者、站长或运维人员这款黑色简洁风格的 PHP 短网址生成源码可部署在自己的服务器上避开第三方短链平台在域名、隐私或统计功能上的限制实现数据与广告位后台自主管理。前端支持创建普通/自定义短链、密码保护、链接统计、暗色主题和书签脚本并集成复制、分享操作后端可删除网址、编辑站点设置、添加/编辑广告、分析访问数据也可注入自定义 CSS 调整界面适合个人工具站、博客外链或企业内链中转。压缩包为 RAR 格式共 103 个文件核心为 34 个 PHP 文件与 11 个 JS、10 个 CSS另有 scss/less 预处理样式、字体文件和 2 个 SQL 数据库脚本整体约 681KB轻量易部署前端基于 Bootstrap、Font Awesome 等常用样式库响应式设计在移动端也能获得一致体验。已有 212 人学习下载整套源码目录结构清晰可快速完成安装与二次开发既能直接当作短链接工具使用也能从中借鉴 PHP 链接管理、统计分析和暗色主题的实现思路。1. 一个 .rar 里装的到底是什么PHP 短网址源码没那么玄乎收到“黑色简洁的PHP短网址短链接生成源码.rar”这种包第一反应别急着解压。这类源码在二手源码站上很常见黑色简洁说的是 UI 层用了深色主题PHP 是后端语言短网址是它要解决的核心问题。说直白点短网址服务就是一张“短码到长链接”的映射表生成短码、存下来、访问时跳转。这套源码的价值不在黑底色 UI而在于把“不依赖第三方平台、数据在自己手里”的能力做齐了。短视频外链被拦截、短信里塞不下长 URL、二维码容错率不够这些场景都需要一个能自己部署的短网址系统。适合谁手上有 PHP 虚拟主机或小服务器的个人站长想给内部系统做短链服务的人以及想完整跑通一个 PHP 项目结构的新手。这篇文章就按这个方向把这套源码从原理到部署、从参数到排查拆开讲。2. 短网址系统的核心逻辑短码生成、重定向与状态码选择2.1 短码就是主键映射表才是本体很多人第一次看短网址源码都会去找“压缩算法”找半天发现根本没有。短网址不是压缩长链接并没有被压短它只是一条记录的主键。你拿到一串“https://d.com/Ab3x9”真正起作用的是 Ab3x9 这个短码服务端用它在数据库里查到对应的长链接然后发一个重定向头让浏览器跳过去。最小可用系统就三个动作接收长 URL → 生成短码 → 落库访问时取短码 → 查库 → 跳转。整个链路没有黑匣子任何一个 PHP 开发者都能写难的是把短码撞库、伪静态路由、状态码缓存这些边角处理干净。这套源码如果结构完整你应该能在里面看到四个东西入口路由、短码生成函数、数据库操作类和一个深色后台页面。2.2 短码生成随机短码与自增转进制两条路短码生成算法决定了一个短网址服务的容量和安全性。常见的 PHP 实现有两条路一是随机短码用 random_bytes 取随机字节再转成字母数字二是自增 ID 转 62 进制把数据库主键转成短码。随机短码的好处是外部无法枚举别人猜不出你下一个短码是什么适合对外公开的服务。自增转 base62 的好处是无碰撞、生成速度快但短码按顺序排列容易被遍历抓取适合内部系统或登录后才能用的场景。我见过的同类 PHP 短网址包里随机短码占多数因为部署简单不需要维护自增序列。?php // 随机短码random_bytes 是 PHP 7.0 引入的密码学安全随机源 function generate_short_code(int $length 6): string { $bytes random_bytes(6); // 取 6 字节随机数 $hex bin2hex($bytes); // 转成十六进制字符串 // 截断到目标长度短码只保留字母数字避免特殊字符进 URL return substr($hex, 0, $length); }这段代码逻辑很直接random_bytes 生成 6 字节随机数bin2hex 转成 12 位十六进制串再截前 6 位。参数 length 控制短码长度调成 4 就是 4 位短码调成 8 就是 8 位。注意 random_bytes 在 PHP 7.0 才有如果你要部署的环境还是 PHP 5.x这一段直接报错后面避坑章节会细说。自增转 base62 的写法长一点但思路更传统?php // 自增 ID 转 62 进制短码无碰撞但可枚举 const SHORT_CHARS 0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ; function id_to_short(int $id): string { $code ; $base strlen(SHORT_CHARS); // 62 while ($id 0) { $code SHORT_CHARS[$id % $base] . $code; $id intdiv($id, $base); } return $code ! ? $code : SHORT_CHARS[0]; }这套逻辑把主键按 62 进制一位一位拆出来映射到数字、小写字母、大写字母上。十万条数据只要 3 位短码就装得下百万条也只要 4 位。代价是短码有规律别人能顺着你的短码扫出全站链接。所以对外服务我一般不用这条路对内系统用它很舒服。2.3 跳转实现301 与 302 的选择是个坑短码生成只是前半场真正决定用户体验的是跳转那一行代码。PHP 里最朴素的写法就是?php // 短码跳转统一用 302方便后续改目标地址和统计 require_once __DIR__ . /db.php; $code $_GET[code] ?? ; if ($code ) { http_response_code(400); exit(缺少短码); } $target find_url_by_code($code); if (!$target) { http_response_code(404); exit(短链接不存在或已过期); } header(Location: . $target, true, 302); exit;这里唯一需要纠结的是状态码选 301 还是 302。301 是永久重定向浏览器和搜索引擎会缓存这个结果当你改了长链接目标地址老用户访问短码可能还是跳到旧地址——这是短网址系统最常见的翻车点。302 是临时重定向每次请求都回服务器查一次库跳转目标随时能改点击次数也能准确统计。所以做短网址服务我不管源码里默认写的什么一律改成 302。只有一种情况例外你确定某个短码对应的长链接永远不变又想省服务器压力才用 301。另外注意 header() 之后必须 exit否则 PHP 脚本继续往下执行可能输出多余内容污染响应。2.4 存储层选型MySQL 还是 SQLite去查这套源码的数据库配置文件你会发现有两种写法一种连 MySQL一种用 SQLite。选哪个不取决于源码取决于你的部署环境。存储方式适用场景并发上限部署复杂度SQLite虚拟主机、个人小站、日请求几百次几百 QPS 内零配置文件即库MySQL独立服务器、对外开放服务高并发无压力需要建库建用户如果你只有一台虚拟主机没有 phpMyAdmin 权限SQLite 是唯一靠谱的路。PDO 封装的好处就在这切换数据库只需要改 DSN 一行配置sqlite:/path/to/db.sqlite 改成 mysql:hostlocalhost;dbnameshorturl。前提是源码里的 SQL 语句没用到 MySQL 独有语法比如 ENGINEInnoDB 这种建表语句在 SQLite 里就得删掉。后面部署章节会给一套两边都能跑的表结构。3. 把黑色简洁的短网址源码跑起来环境、路由与最小部署3.1 环境要求PHP 版本与扩展两个前提解压 .rar 之后第一步不是改代码是确认环境。PHP 短网址源码最怕遇到老版本虚拟主机PHP 5.2、5.3 还在服役的并不少见。需要满足两个前提PHP 7.4 以上版本以及 pdo、pdo_mysql 或 pdo_sqlite 扩展。判断方法很直接php -v php -m | grep -i pdo第一行看版本号第二行看 PDO 扩展装没装。如果输出里一个 pdo 都没有这个源码基本跑不起来因为短网址系统的数据库操作层就是用 PDO 写的。顺手再看一下 openssl、json 扩展PHP 5.6 以后的默认发行版基本都带但有些精简版虚拟主机会缺。环境不对后面全是白费功夫这一步别跳。3.2 伪静态路由Apache 与 Nginx 两条配置短网址系统对路由有一个硬性要求用户访问 /Ab3x9 时服务器要把 Ab3x9 当成参数传给 PHP 脚本。这就是伪静态Nginx 下叫 rewriteApache 下叫 .htaccess。Apache 的配置通常写在网站根目录的 .htaccessRewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?code$1 [QSA,L]这段规则的意思是如果请求的不是真实文件也不是真实目录就把整条路径交给 index.phpcode 参数就是短码。QSA 表示保留原有 query stringL 表示这是最后一条规则。习惯用 Apache 的虚拟主机一般都已经开启 mod_rewrite如果 404去查一下是否 AllowOverride All。Nginx 下没有 .htaccess要改站点配置文件location / { try_files $uri $uri/ /index.php?$query_string; }try_files 的意思是先找真实文件再找真实目录都找不到就把请求交给 /index.php同时把原始 query string 带上。这两条配置的效果一样但很多人在 Nginx 里图省事写成 rewrite ^(.*)$ /index.php last;少了 query string短码参数就丢了访问 http://yourdomain.com/Ab3x9 直接 404手动访问 index.php?codeAb3x9 却正常。这个现象是短网址部署的头号坑排查章节还会重点说。3.3 安装三步检查入口文件与建表放下源码包后我一般按三步走确认环境、建库建表、改配置。第一步前面说过了第二步是把数据库结构建出来。这套建表语句兼容 MySQL 和 SQLite 的常见用法CREATE TABLE IF NOT EXISTS short_urls ( id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY, short_code VARCHAR(16) NOT NULL UNIQUE, long_url TEXT NOT NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, expires_at DATETIME NULL, hits INT UNSIGNED NOT NULL DEFAULT 0, INDEX idx_expires (expires_at) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;short_code 加唯一索引是关键这是防撞码的最后一道防线。假如生成逻辑有 bug两条相同短码插进表里唯一索引会直接报错拦住而不是让后一条覆盖前一条。expires_at 默认 NULL 表示不过期按业务需要再填时间。SQLite 下把 ENGINEInnoDB 那句去掉就行其它语法通用。第三步是改配置文件里的数据库连接常见做法是单独一个 config.php?php // 数据库连接配置SQLite 与 MySQL 二选一 define(DB_TYPE, sqlite); // sqlite 或 mysql define(SQLITE_PATH, __DIR__ . /data/shorturl.db); define(DB_HOST, localhost); // MySQL 专用 define(DB_NAME, shorturl); // MySQL 专用 define(DB_USER, root); // MySQL 专用 define(DB_PASS, your_password); // MySQL 专用把 DB_TYPE 改成 sqlite程序就会走 SQLite 连接改成 mysql就用后面四项连 MySQL。数据库连接类里的 DSN 一般会根据这个常量拼出来不要自己去改连接代码改配置即可。提示上传到虚拟主机后如果页面空白先看 PHP 错误日志路径通常在 /logs/php_error.log 或 web 目录下的 error_log。这一步能区分是语法错误还是数据库连接失败。4. 三个必调参数与数据结构设计短码长度、冲突重试与过期策略4.1 短码长度与字符集怎么定源码默认的短码长度可能很短上线前一定要自己算一笔账。短码用的字符集通常是 62 个字符数字 10 个、小写字母 26 个、大写字母 26 个短码长度组合数实际容量评估建议4 位62^4 ≈ 1470 万十万条内可用过百万开始吃紧不推荐5 位62^5 ≈ 9.1 亿千万条级别无压力可接受6 位62^6 ≈ 568 亿亿级业务都够推荐我一般默认 6 位理由不是容量不够而是 4 位短码在亿级组合下依然能被暴力枚举攻击者可以从 aaaa 一路试到 zzzz把所有短码扫一遍。6 位组合数足够大扫描成本高同时 URL 又不至于太长。字符集也有讲究。62 个字符里有几组长得像的数字 0 和字母 O、数字 1 和字母 l 和字母 I。用户收到短码后是肉眼复制遇到 oO0 混在一起就很容易输错。如果不介意损失一点容量我建议字符集去掉这几个易混字符62 个字母数字收成 58 个换来的是用户报错率明显下降。4.2 冲突重试唯一索引才是底线短码生成再随机也有撞库的可能。两套独立进程同时生成同一个短码数据库里只能留一条。源码里如果有“先 SELECT 查重再 INSERT”这种写法趁早改掉因为两个请求可能同时查不到又同时插入查重形同虚设。正确做法是直接把 INSERT 丢给数据库靠唯一索引报错来感知冲突?php // 带冲突重试的插入依赖 short_code 的唯一索引兜底 function insert_short_url(string $code, string $long_url, ?string $expires_at null): bool { global $pdo; for ($attempt 0; $attempt 3; $attempt) { try { $stmt $pdo-prepare( INSERT INTO short_urls (short_code, long_url, expires_at) VALUES (?, ?, ?) ); $stmt-execute([$code, $long_url, $expires_at]); return true; } catch (PDOException $e) { // SQLSTATE 23000 是唯一索引冲突 if (strpos($e-getMessage(), 23000) false) { throw $e; } // 撞码了换一个新的短码重试 $code generate_short_code(6); } } return false; }这段代码把重试次数控制在 3 次以内3 次都撞码的概率约等于零。逻辑说明两点一是捕获 PDOException 后要判断是不是 23000数据库连接挂了也走这个异常不能盲目重试二是撞码后重新调 generate_short_code 生成新码不要用原来的短码加后缀否则短码长度不可控。4.3 过期策略expires_at 与定时清理很多短网址源码没有过期功能短码一旦生成就永久有效。如果你的场景是活动链接、临时分享最好把过期时间用起来否则垃圾短码会越积越多。查询的时候加一个过滤条件过期的不返回SELECT long_url FROM short_urls WHERE short_code ? AND (expires_at IS NULL OR expires_at NOW());注意这里的括号expires_at IS NULL 表示永久有效expires_at NOW() 表示还没过期两个条件用 OR 连接整个组用括号包住避免和 short_code 条件产生优先级问题。清理过期数据用定时任务每天凌晨跑一次0 3 * * * php /var/www/shorturl/cleanup_expired.phpcleanup_expired.php 里就一条 DELETE按 expires_at 把过期数据批量清掉。如果数据量大DELETE 加上 LIMIT 分批删避免一次删几十万行把数据库锁死。4.4 URL 编码的边界中文与已有百分号这节容易被忽略但线上出问题最多的往往在这。用户提交的长链接可能带中文、空格、Emoji直接存库、直接跳转浏览器拿到 Location 头经常解析失败跳过去 404。常见误用是对整个 URL 调 rawurlencode这会把 URL 里已有的合法百分号编码也二次转义比如原始链接里有个 %20rawurlencode 之后变成 %2520跳过去还是一样 404。正确做法是只编码非 ASCII 那一段?php // 只编码非 ASCII 字符保留 URL 里已有的合法转义 function encode_url_for_location(string $url): string { return preg_replace_callback(/[^\x00-\x7F]/, function (array $matches) { return rawurlencode($matches[0]); }, $url); }这段正则把 URL 里的非 ASCII 字节挑出来单独编码ASCII 部分原样保留。入库前也建议用这个函数处理一遍保证数据库里存的是合法 URL 字符串跳转时直接用不要二次编码。5. 短链接系统的常见坑与排查5 条血泪经验5.1 Nginx 下短链接全部 404手动带参数却正常现象访问 http://yourdomain.com/Ab3x9 返回 404访问 http://yourdomain.com/index.php?codeAb3x9 却正常跳转。 原因Nginx 伪静态规则没把短码参数传给 PHP或者 rewrite 规则丢了 query string。 解决用 try_files 而不是裸 rewrite。站点的 location 配置改成location / { try_files $uri $uri/ /index.php?$query_string; }改完记得 nginx -s reload。验证方法是访问任意一个不存在的路径看地址栏有没有变成 index.php?codexxx如果变成说明参数没传过去。反复出现这个问题直接放弃 rewrite用 try_files 一劳永逸。5.2 后台改了目标地址用户还是跳到旧页面现象在后台把某条短码的长链接从 A 改成 B老用户访问短码还是跳到 A。 原因前一个版本用了 301 永久重定向浏览器和搜索引擎已经把它缓存了后续访问不再请求服务器直接走本地缓存。 解决全站统一改用 302。已经发出的 301 短码没办法召回只能生成新短码替换旧链接。排查方法是用 curl -I 访问短码看响应头里的 HTTP 状态码curl -I https://yourdomain.com/Ab3x9如果返回 HTTP/1.1 301 Moved Permanently赶紧改源码里的 header 状态码。这条坑影响的是所有历史短码越早上线越难收拾。5.3 本地运行正常上传虚拟主机后白屏现象Windows 本地 PHP 环境跑得好好的传到虚拟主机后一片空白什么错误都不显示。 原因虚拟主机 PHP 版本偏低源码用了 ?? 运算符、random_bytes、intdiv 这类 PHP 7 才有语法和函数PHP 5.x 直接解析失败加白屏。 解决先 php -v 看虚拟主机版本PHP 7.4 以下就不要挣扎了。如果源码必须兼容老环境把 ?? 改成 isset($_GET[code]) ? $_GET[code] : 把 random_bytes 换成 mt_rand 拼字符串的兼容方案。不过这属于治标能换 PHP 7.4 的环境就换PHP 5 连安全更新都没了。5.4 并发一上来偶尔几条请求返回 500现象日常流量没事一到活动流量进来少量短码创建请求直接报 500。 原因两个请求生成了同一个随机短码同时 INSERT撞了唯一索引异常没有被捕获PHP 直接抛 500。 解决把插入操作包在 try-catch 里捕获 SQLSTATE 23000 后重新生成短码再试一次。第 4.2 节那段代码就是干这个的。排查时打开 PHP 错误日志看到 Duplicate entry for key short_code 就说明撞码了。5.5 带中文参数的链接跳转后 404现象用户提交的长链接带中文查询参数短码访问时跳到一个打不开的地址。 原因Location 响应头里的非 ASCII 字符没有编码浏览器解析时把中文和后面的参数截断了。 解决入库前和跳转前都用第 4.4 节那个 encode_url_for_location 处理只编码非 ASCII 段。千万不能用原始字符串直接拼 URL也不能对整个链接做 rawurlencode。判断标准跳转过去后的地址栏和原始链接逐字符对比有差别就看是哪一段被动了。提示这五条里 5.1、5.2 是环境层面的坑改一次配置就能避免5.3、5.4、5.5 是代码层面的边界问题排查时先看日志别靠肉眼猜。6. 把这些 PHP 短网址能力做厚API 化、统计与自定义短码基础跳转跑通只算完成了 50%剩下 50% 是把短网址真正接进业务。最常用的扩展是 API 化让前端页面通过 AJAX 直接生成短码而不是每次都要进后台?php // api/create.php返回 JSON方便前端调用 header(Content-Type: application/json; charsetutf-8); require_once __DIR__ . /db.php; $long_url $_POST[url] ?? ; if ($long_url || !filter_var($long_url, FILTER_VALIDATE_URL)) { echo json_encode([code 0, msg URL 不合法]); exit; } $code generate_short_code(6); insert_short_url($code, $long_url); echo json_encode([code 1, short_url https://your.domain/ . $code]);filter_var 校验 URL 格式能挡住一半无效输入。返回的 short_url 直接用拼接域名写你自己的不要写死。前端拿到这个 JSON 后把短码渲染成二维码或复制按钮。统计功能也不难跳转命中时把 hits 字段累加就行UPDATE short_urls SET hits hits 1 WHERE short_code ?;要按天统计就在短码表之外再建一张访问日志表记录访问时间、来源 IP、User-Agent定时任务归档。自定义短码是用户很喜欢的一个功能生成短码时接收一个 code 参数先查重没用过就直接用。这就把短码从随机串变成了品牌词比如 https://your.domain/vip 比 https://your.domain/k2Jd8x 清晰得多。至于黑色简洁的界面通常是用 CSS 变量集中管理主题色背景色、卡片色、强调色各自定义在 :root 里换肤只改几个变量不动业务代码。很多深色 UI 的 PHP 后台都是这个套路也是这套源码“黑色简洁”四个字落到代码里的位置。我上线短链接服务前有个习惯先用 curl 把状态码检查一遍再把短码长度改成 6 位最后把 Nginx 的 try_files 抄进配置这三步能挡住短网址系统八成日常问题。希望帮到你。本文还有配套的精品资源点击获取
