前言
在这个营销的时代,短链接和二维码是企业进行营销中非常重要的工具,不仅仅是缩短了链接,而且还可以通过扩展获得更多的数据,诸如点击数、下载量、来源以及时间等等。
网上搜寻了一下比较有名有U.NU和0x3.me,但前者只能统计点击次数,而且不能修改链接,后者功能丰富,但确是收费商业网站。
环境搭建
本安装指南将帮助您安装Polr 2.0的最新版本Polr 2.0。Polr 是一个开源软件、世界上最好的语言,功能还算强大。
功能包括
- 修改缩短的域名
- 统计功能(来源,时间)
- API支持
- 二维码生成
服务器要求
- Apache, nginx, IIS, or lighttpd (Apache preferred)
- PHP >= 5.5.9
- MariaDB or MySQL >= 5.5, SQLite alternatively
- composer
- PHP requirements:
OpenSSL PHP Extension
PDO PHP Extension
PDO MySQL Driver (php5-mysql on Debian & Ubuntu, php5x-pdo_mysql on FreeBSD)
Mbstring PHP Extension
Tokenizer PHP Extension
JSON PHP Extension
PHP curl extension
安装PHP
PHP http://php.net/downloads.php
wget http://ba1.php.net/get/php-5.6.34.tar.gz/from/this/mirror
安装libxml2和libxml2-devel
yum -y install libxml2
yum -y install libxml2-devel
因为不同的操作系统环境,系统安装开发环境包的完整程度也不相同,所以建议安装操作系统的时候做必要选择,也可以统一执行一遍所有的命令,将没有安装的组件安装好,如果已经安装了可能会进行升级,版本完全一致则不会进行任何操作,命令除上面2个之外,汇总如下:
yum -y install libxml2
yum -y install libxml2-devel
yum -y install openssl
yum -y install openssl-devel
yum -y install curl
yum -y install curl-devel
yum -y install libjpeg
yum -y install libjpeg-devel
yum -y install libpng
yum -y install libpng-devel
yum -y install freetype
yum -y install freetype-devel
yum -y install pcre
yum -y install pcre-devel
yum -y install libxslt
yum -y install libxslt-devel
yum -y install bzip2
yum -y install bzip2-devel
yum -y install libjpeg libjpeg-devel libpng libpng-devel freetype freetype-devel mysql pcre-devel
安装完成之后,执行配置:
./configure --prefix=/usr/local/php --with-curl --with-freetype-dir --with-gd --with-gettext --with-iconv-dir --with-kerberos --with-libdir=lib64 --with-libxml-dir --with-mysqli --with-openssl --with-pcre-regex --with-pdo-mysql --with-pdo-sqlite --with-pear --with-png-dir --with-jpeg-dir --with-xmlrpc --with-xsl --with-zlib --with-bz2 --with-mhash --enable-fpm --enable-bcmath --enable-libxml --enable-inline-optimization --enable-gd-native-ttf --enable-mbregex --enable-mbstring --enable-opcache --enable-pcntl --enable-shmop --enable-soap --enable-sockets --enable-sysvsem --enable-sysvshm --enable-xml --enable-zip
然后执行编译:
make
编译时间可能会有点长,编译完成之后,执行安装:
make install
php的默认安装位置上面已经指定为/usr/local/php,接下来配置相应的文件:
cp php.ini-development /usr/local/php/lib/php.ini
cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf
cp sapi/fpm/php-fpm /usr/local/bin
然后设置php.ini,使用: vi /usr/local/php/lib/php.ini 打开php配置文件找到cgi.fix_pathinfo配置项,这一项默认被注释并且值为1,根据官方文档的说明,这里为了当文件不存在时,阻止Nginx将请求发送到后端的PHP-FPM模块,从而避免恶意脚本注入的攻击,所以此项应该去掉注释并设置为0
创建web用户:
groupadd www-data
useradd -g www-data www-data
修改php-fpm.conf添加以上创建的用户和组,这时候使用 vi /usr/local/etc/php-fpm.conf 打开文件后找到官方所提示的位置:
user = www-data
group = www-data
执行以下命令启动php-fpm服务:
php-fpm
启动完毕之后,php-fpm服务默认使用9000端口,使用 netstat -tln | grep 9000 可以查看端口使用情况。
你也可以使用 ps -ef|grep php 命令查看进程。
停止 php-fpm
killall php-fpm
下载源代码
如果你想下载一个稳定版本的Polr,你可以查看发布页面。
$ cd /var/www
$ git clone https://github.com/cydrobolt/polr.git --depth=1
#你也可以下载码云中国汉化版
$ git clone https://gitee.com/skywalker512/polr.git
$ chmod -R 755 polr
$ chown -R www-data polr
$ cd polr
$ cp .env.setup .env
Composer 安装
切换到 polr目录下
# download composer package
curl -sS https://getcomposer.org/installer | php
# update/install dependencies
php composer.phar install --no-dev -o
如果由于PHP版本的原因,编写器无法安装适当的依赖项,请删除composer.lock 并重新尝试安装依赖项。
rm composer.lock
php composer.phar install --no-dev -o
Nginx 安装
推荐您使用yum安装以下的开发库:
yum install readline-devel pcre-devel openssl-devel -y
Docker容器还可能要安装:
yum install wget perl gcc -y
下载最新版本:
wget https://openresty.org/download/openresty-1.11.2.4.tar.gz
解压并重命名:
tar -xvf openresty-1.11.2.4.tar.gz
mv openresty-1.11.2.4 openresty
安装配置:
./configure
您可以使用下面的命令来编译安装:
make && make install
如果您的电脑支持多核 make 工作的特性, 您可以这样编译安装:
make && make install -j2
为了方便启动,建立软连接:
ln -s /usr/local/openresty/nginx/sbin/nginx /usr/sbin/nginx
配置文件
vi /usr/local/openresty/nginx/conf/nginx.conf
server {
listen 80;
listen 443 ssl;
server_name polr.52itstyle.com;
index index.php;
#证书路径
ssl_certificate /usr/local/openresty/nginx/cert/214545352540632.pem;
#私钥路径
ssl_certificate_key /usr/local/openresty/nginx/cert/214545352540632.key;
#缓存有效期
ssl_session_timeout 5m;
#可选的加密算法,顺序很重要,越靠前的优先级越高.
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
#安全链接可选的加密协议
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
root /var/www/polr/public;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
try_files $uri =404;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTP_HOST $server_name;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
安装运行
进入https://polr.52itstyle.com/setup 进行安装,设置一些相关选项即可
安装成功,首页:
后台管理:
短链接演示网址:https://polr.52itstyle.com/
Polr API文档
API密钥
要将用户认证为Polr,您需要提供一个API密钥以及对Polr API的每个请求,作为GET或POST参数。(例如?key=API_KEY_HERE)
分配API密钥
要分配API密钥,请从管理员帐户登录,转到“管理员”选项卡,然后滚动到所需的用户。从那里,您可以打开API按钮下拉菜单来重置,创建或删除用户的API密钥。您还将被提示设置所需的API配额。这被定义为每分钟的请求。您可以通过使配额成为负数来允许无限制的请求。一旦用户收到API密钥,他们将能够在其用户面板中看到一个“API”选项卡,该选项卡提供了与API进行交互所需的信息。
操作
操作作为网址中的细分受众群传递。目前有两项行动得到执行:
- shorten - 缩短网址
- lookup - 查找缩短的URL的目的地