---
title: Polr Setup
tags: 自學文件
---

設定 Polr 縮網址服務

[TOC]

## 安裝 Composer
在家目錄底下：

# 下載 Composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# 驗證檔案 Hash 值
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e5325b19b381bfd88ce90a5ddb7823406b2a38cff6bb704b0acc289a09c8128d4a8ce2bbafcd1fcbdc38666422fe2806') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

## 出現 "Installer verified" 表示檔案驗過了

# 全域安裝 Composer
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

出現 `Composer (version 1.10.9) successfully installed to: /usr/local/bin/composer`
那 Composer 的安裝就告一段落

## 設定 Polr

# 先抓 Polr 下來
cd /var/www
sudo git clone https://github.com/cydrobolt/polr.git --depth=1

# 設定一下權限
sudo chmod -R 755 polr
sudo chown -R www-data polr

# 安裝 PHP 相關套件
cd polr
sudo composer install --no-dev -o

# 使 Polr 變成安裝環境
sudo cp .env.setup .env
sudo chown www-data .env 

- Deprecation Notice 的警告可以忽略
- 不要出現紅底錯誤訊息就好

## 設定 Apache

sudo vim /etc/apache2/sites-available/polr.conf

<VirtualHost *:80>
    ServerName example.com # 記得這裡要改掉
    ServerAlias example.com # 記得這裡要改掉

    DocumentRoot "/var/www/polr/public"
    <Directory "/var/www/polr/public">
        Require all granted
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

sudo a2enmod rewrite
sudo a2ensite polr.conf
sudo systemctl restart apache2

## 安裝 SSL 證書 (跑 HTTPS 要用到)
- 安裝 certbot

sudo apt install certbot python-certbot-apache

- 執行 certbot

sudo certbot

初次執行會要求你填 Email 地址、是否同意 ToS 以及是否參與他們的計畫

之後選擇你要安裝 SSL 的網址
並自行選擇是否要重新導向 (Redirect)

很懶人啦，不用特別記

## 安裝 Polr
幾個地方要注意：
- 建立資料庫時，在 phpmyadmin 當中編碼那欄選擇空白
- 讓它自己抓適合的
- Applicaton Prtocol 記得要改成 `https://`
- **安裝時開啟註冊功能（帶有 Register 的那個），否則無法順利安裝**
- 這應該是 bug
- 反正後續還是可以透過修改 `.env` 關閉註冊功能
- `POLR_ALLOW_ACCT_CREATION=1` 改成 `0` (大約在 49 行)

有問題去 `.env` 把 DEBUG 模式打開後
在發生錯誤的頁面重新整理

## 範例連結
- HackMD Profile - https://url.nesquate.tw/cTc3z

## 參考來源
- [Polr 官方文檔](https://docs.polrproject.org/en/latest/user-guide/installation/)
- [Composer 官方文檔](https://getcomposer.org/doc/00-intro.md)