最近工作中遇到一个需求,将app下载地址变成短链接进行推广,索性就研究了下yourls 。
发现这个玩意功能挺强大的,不但可以批量生成自己的短地址,还可以管理,统计每个短地址点击数量,还可以提供api接口。
最重要的是,这个开源免费,自己拿来做二次开发再适合不过了。
下面介绍怎么一步步搭建yourls
服务器要求:
- 至少PHP 5.6 如果要使用api 还需要有curl拓展
- 至少MYSQL 5
1、直接本地克隆或者下载yourls代码
git https://github.com/YOURLS/YOURLS.git
2、将user目录下的config-sample.php 重命名 为 config.php
3、修改config.php里面的配置参数 (linux上注意:config.php这个文件权限最好跟启动Web服务器用户一致,不然可能加密密码保存不了)
define( 'YOURLS_DB_USER', 'root' ); define( 'YOURLS_DB_PASS', '123456' ); define( 'YOURLS_DB_NAME', 'yourls' ); define( 'YOURLS_DB_HOST', 'localhost' ); define( 'YOURLS_DB_PREFIX', 'yourls_' ); //上面是数据信息不用多说 define( 'YOURLS_SITE', 'http://test.com' ); //你自己服务器的域名 用最短的,短地址也是基于这个生成。 define( 'YOURLS_HOURS_OFFSET', '+8'); //时区偏移 define( 'YOURLS_LANG', 'zh_CN' ); //这个语言默认是英文,没有中文包,需要自己去 https://github.com/guox/yourls-zh_CN/下载,放到 user/languages 里面 define( 'YOURLS_UNIQUE_URLS', true ); //短地址是否唯一 define( 'YOURLS_PRIVATE', true ); //是否私有,如果私有的,则进行api调用生成短地址时需要传递用户名和密码 define( 'YOURLS_COOKIEKEY', 'A2C7&H~r80pTps{nIfI8VFpTxnfF3c)j@J#{nDUh' );//加密cookie 去 http://yourls.org/cookie 获取 $yourls_user_passwords = array( 'admin' => '123456' /* Password encrypted by YOURLS */ , //用户名=>密码 可填多个 登录成功后这里的明文密码会被加密 ); define( 'YOURLS_DEBUG', false ); //是否开启调试 define( 'YOURLS_URL_CONVERT', 62 ); //使用36进制 还是62进制 这个最好一开始设好不要修改,避免地址冲突,建议62进制 $yourls_reserved_URL = array( 'porn', 'faggot', 'sex', 'nigger', 'fuck', 'cunt', 'dick', //排除一下短地址,这些地址是不会生成的 );
4、服务器配置
上传到服务器
apache
(1)配置里开启 mod_rewrite 模块
(2)创建 .htaccess 文件
#.htaccess 文件内容,如果是根目录下 http://yoursite/ # BEGIN YOURLS <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^.*$ /yourls-loader.php [L] </IfModule> # END YOURLS #如果是二级目录下 http://yoursite/somedir/ # BEGIN YOURLS <IfModule mod_rewrite.c> RewriteEngine On RewriteBase /somedir/ RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^.*$ /somedir/yourls-loader.php [L] </IfModule> # END YOURLS
nginx
server { # HTTP over IPv4 & IPv6 listen 80; listen [::]:80; # HTTPS over IPv4 & IPv6 listen 443 ssl; listen [::]:443 ssl; ssl_certificate example.com.crt; ssl_certificate_key example.com.key; server_name example.com www.example.com; # Root directory root /path/to/yourls/files; # Rewrites 主要看这一项配置就够了,路由重写 location / { try_files $uri $uri/ /yourls-loader.php$is_args$args; } # PHP engine location ~ .php$ { include fastcgi.conf; # include fastcgi_params; fastcgi_index index.php; fastcgi_pass unix:/var/run/php/php7.1-fpm.sock; } }
5、重启web服务器,浏览器 输入 http://域名/admin,然后选择安装即可安装成功
(1) 如果安装报错,或者不跳转,那有可能是你的php 或者 mysql 版本过低;
(2) 还有可能创建数据库失败,可以选择手动创建:
1 create databases yourls; 2 CREATE TABLE `yourls_url` ( 3 `keyword` varchar(200) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL, 4 `url` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL, 5 `title` text, 6 `timestamp` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP, 7 `ip` varchar(41) NOT NULL, 8 `clicks` int(10) unsigned NOT NULL, 9 PRIMARY KEY (`keyword`), 10 KEY `timestamp` (`timestamp`), 11 KEY `ip` (`ip`) 12 ) ENGINE=InnoDB DEFAULT CHARSET=utf8; 13 14 CREATE TABLE `yourls_options` ( 15 `option_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, 16 `option_name` varchar(64) NOT NULL DEFAULT '', 17 `option_value` longtext NOT NULL, 18 PRIMARY KEY (`option_id`,`option_name`), 19 KEY `option_name` (`option_name`) 20 ) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8;
21 CREATE TABLE `yourls_log` ( 22 `click_id` int(11) NOT NULL AUTO_INCREMENT, 23 `click_time` datetime NOT NULL, 24 `shorturl` varchar(200) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL, 25 `referrer` varchar(200) NOT NULL, 26 `user_agent` varchar(255) NOT NULL, 27 `ip_address` varchar(41) NOT NULL, 28 `country_code` char(2) NOT NULL, 29 PRIMARY KEY (`click_id`), 30 KEY `shorturl` (`shorturl`) 31 ) ENGINE=InnoDB DEFAULT CHARSET=utf8; 32 33 INSERT INTO `yourls`.`yourls_options`(`option_id`, `option_name`, `option_value`) VALUES (1, 'version', '1.7.4'); 34 INSERT INTO `yourls`.`yourls_options`(`option_id`, `option_name`, `option_value`) VALUES (2, 'db_version', '482'); 35 INSERT INTO `yourls`.`yourls_options`(`option_id`, `option_name`, `option_value`) VALUES (3, 'next_id', '1553242197'); 36 INSERT INTO `yourls`.`yourls_options`(`option_id`, `option_name`, `option_value`) VALUES (4, 'active_plugins', 'a:1:{i:0;s:20:"random-bg/plugin.php";}'); 37 INSERT INTO `yourls`.`yourls_options`(`option_id`, `option_name`, `option_value`) VALUES (5, 'core_version_checks', 'O:8:"stdClass":4:{s:15:"failed_attempts";i:0;s:12:"last_attempt";i:1553161787;s:11:"last_result";O:8:"stdClass":2:{s:6:"latest";s:5:"1.7.3";s:6:"zipurl";s:56:"https://api.github.com/repos/YOURLS/YOURLS/zipball/1.7.3";}s:15:"version_checked";s:5:"1.7.4";}');
6、短地址默认是是按照顺序生成,从1开始,有可能我们想不按照这样顺序,可以推荐用时间戳来生成
只需要修改 includes/functions.php 272行左右
将 $id = yourls_get_next_decimal(); 改为 $id = time();
7、api接口生成
请求地址:http://域名//yourls-api.php
参数:username(用户名)、password(密码)、format(格式 json)、url(长地址)、action(功能,shorturl)
返回:
{ "url": { "keyword": "1H7fa7", "url": "http://www.baidu.com/download/index.html?player_id=2", "title": "下载页面", "date": "2019-03-22 08:04:23", "ip": "127.0.0.1" }, "status": "success", "message": "http://www.baidu.com/download/index.html?player_id=2 已保存为", "title": "下载页面", "shorturl": "http://test.com/1H7fa7", "statusCode": 200 }
上面的 shorturl 就是生成的短链接,也可以在后台直接生成指定的短链接。
每个短链接后面拼接一个 + ,就可以查看这个链接的点击情况,例如:http://test.com/1H7fa7+
很多网友在网上通过短网址发布信息时,无法统计是通过哪个渠道点击。
今天分享一个程序,这款程序不仅可以生自定义的短网址,还可以统计点击信息。
PS:
其实,用自己的域名不仅可以显得出逼格,其实更重要的是为了更好的统计转化。短网址,重要的是短,所以建议注册个短的域名
简介
YOURLS是一款使用PHP+Mysql开发的短链接程序,相比公共短网址好处是数据掌握在自己手中,可控性更高。
截图
1、下载
YOURLS免费开源,可以在Github下载最新版本(https://github.com/YOURLS/YOURLS/releases)
,解压后放到站点根目录,并将config-sample.php更名为config.php。
YOURLS的安装就是个普通建站的过程,我用的是阿里云服务器,安装宝塔控制面板建站。
如果不会安装宝塔,可参考:https://yq.aliyun.com/articles/685978
用宝塔建站,可参考:https://aliyun.gaomeluo.com/409.html
需要先新建一个MySQL数据库,并设置好账号、密码(略过),然后修改user/config.php配置文件,填写正确的MySQL信息,配置信息如下。
#数据库用户名 define( 'YOURLS_DB_USER', 'xxxxxx' ); #数据库密码 define( 'YOURLS_DB_PASS', 'xxxxxx' ); #数据库名 define( 'YOURLS_DB_NAME', 'xxxxxx' ); #数据库连接地址 define( 'YOURLS_DB_HOST', 'localhost' ); #数据库表前缀,一般保持默认 define( 'YOURLS_DB_PREFIX', 'yourls_' );
#设置用户名和密码,可设置多个用户 $yourls_user_passwords = array( 'username' => 'password', // 'username2' => 'password2', // You can have one or more 'login'=>'password' lines );
#设置站点域名 define( 'YOURLS_SITE', 'http://demo.com' ); #GMT时间偏移 define( 'YOURLS_HOURS_OFFSET', '-5' ); #是否私有 define( 'YOURLS_PRIVATE', 'true' ); #设置cookie,可访问https://api.yourls.org/services/cookiekey/1.0/ 生成 define( 'YOURLS_COOKIEKEY', 'qQ4KhL_pu|s@Zm7n#%:b^{A[vhm' );
location / { try_files $uri $uri/ /yourls-loader.php?$args; }
#启用中文 define( 'YOURLS_LANG', 'zh_CN' );