独自のローカルプレミアムURL短縮サービスを作成する方法

コンテナでサービスを実行している状態で、Webブラウザを開いて https://s.dev 。

構成を行った場合は、このページが表示されます。このページには、URL短縮サービスの要件とセットアップのステータスが表示されます。 Dockerでfauriaコンテナーを使用することにより、すべての依存関係がすでに満たされています。ページの下部にある青いボタンをクリックします。

次のページは、サービスの構成ファイル作成者です。このページでは、以前に作成したデータベースの名前とパスワードをプログラムに指定できます。

上記のように、これらのフィールドに入力する必要があります。 データベースホスト コンテナのローカルホストです。 データベース名 urlshortです 、セットアップで作成しました。 データベースユーザー www-dataです 、およびパスワードは、データベースの初期設定で割り当てたものです。 データベースプレフィックス サービス用に作成された各データベースの開始名です。 short_を使用しました 。インストールプログラムは、セキュリティキーを設定します 。後で参照できるように、与えられたキーのコピーを保管してください。

これを仮想プライベートサーバー（VPS）にインストールする場合、これらの値はそのサービスに応じたものになります。同じものもあれば、変わるものもあります。

適切な情報が揃ったら、ページの下部にある青いボタンを押して、手順3に進みます。

基本構成 画面では、管理者のユーザー名、電子メール、およびパスワードを設定できます。これらを自分に関係する値に設定します。 サイトのURL https://s.devに設定する必要があります hostsで設定した場合 以前にファイルします。設定したら、画面下部の青いボタンを押します。

次の画面は、サービスがセットアップされたことを示しています。 Delete install.phpという青いボタンを押します 。これは実際のウェブサーバーで使用するためのセキュリティ機能ですが、ローカルインストールには必要ありません。ただし、インストールは完了するまで完了しません。

おめでとうございます—サービスは機能しています！上記の画面が表示されます。 長いURLを貼り付けるという名前の入力フィールドに長いURLを指定した場合 次に、青いボタン短縮を押します 、使用する短縮URLを取得します。 URLは、後で参照できるようにデータベースにもあります。この機能は優れたブックマーク作成者になります。

APIの使用

URL短縮サービスを実行しているので、それをうまく利用したいと思うでしょう。ただし、ローカルのWebページであっても、常にWebページを開くと速度が低下します。あなたはそれをより速くする必要があります。そこで、API（Application Programming Interface）を使用すると便利です。 APIの完全なドキュメントを参照できます。

サービスを実行した状態で、 https://s.dev/user/settingsページを開きます。 。

このページを表示するには、アカウントにログインする必要があります。サイドバーの右下に、 APIキー：が表示されます。 英数字で。その番号をコピーして保存します。この番号により、APIにアクセスできます。

APIを利用するために、ルビーを作成できます それにアクセスするためのプログラム。 macOSおよびLinuxでは、通常、Rubyがプリインストールされています。 Windowsでは、インストールする必要があります。

短いリンクを作成するためのRubyの最小限のプログラムは次のとおりです。

require 'net/http'
require 'json'

API = '{YourAPIKey}'

short = JSON.parse(Net::HTTP.get('s.dev', '/api?api=' + API + '&url=' + ARGV[0]))
if short["error"] == 0 then
  print short["short"]
else
  print "An error happened:  "
  print short["error"]
  print "\n"
end

スクリプトをshortener.rbという名前のファイルに保存します 、 {YourAPIKey}を置き換えます 前にコピーしたAPIキーを使用して、コマンドラインで次を実行します。

ruby shortener.rb 'google.com'

そのURLの短縮リンクを取得する必要があります。これにより短縮URLが作成されますが、それでも便利ではありません。

PopClip拡張機能の作成

Macでは、 PopClip ハイライトされたテキストを処理するための素晴らしい小さなプログラムです。短縮リンクの作成を簡単にするために、PopClip拡張機能を作成します。拡張機能の作成についてすべてを説明するつもりはありませんが、チュートリアル PopClip：Scripting Extensionsで拡張機能の作成の仕組みについて読むことができます。 。

PremiumURLShortener.popclipextというPopClip拡張機能を作成します 。 Config.plistには以下を使用します 拡張ディレクトリ内のファイル：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Actions</key>
	<array>
		<dict>
			<key>After</key>
			<string>paste-result</string>
            <key>Image File</key>
            <string>PremiumURLShortener.png</string>
            <key>Script Interpreter</key>
            <string>/usr/bin/ruby</string>
            <key>Shell Script File</key>
            <string>PremiumURLShortener.rb</string>
            <key>Title</key>
            <string>Shortener</string>
		</dict>
	</array>
	<key>Options</key>
	<array>
		<dict>
			<key>Option Identifier</key>
			<string>apikey</string>
			<key>Option Type</key>
			<string>string</string>
			<key>Option Label</key>
			<string>API Key: </string>
		</dict>
	</array>
	<key>Credits</key>
	<array>
	    <dict>
	        <key>Name</key>
	        <string>Richard Guay</string>
	        <key>Link</key>
	        <string>https://customct.com</string>
	    </dict>
	</array>
	<key>Extension Description</key>
	<string>Create shortened URLs with PremiumURLShortener locally</string>
	<key>Extension Identifier</key>
	<string>com.customct.popclip.extension.premiumurlshortener</string>
	<key>Extension Name</key>
	<string>Shortener</string>
	<key>Required Software Version</key>
	<integer>701</integer>
</dict>
</plist>

次に、 PremiumURLShortener.rbという拡張子のスクリプトファイルを作成します。 このコードをその中に配置します：

#!/usr/bin/ruby

require 'net/http'
require 'json'

Encoding.default_internal = Encoding::UTF_8
Encoding.default_external = Encoding::UTF_8

input = ENV['POPCLIP_TEXT'].to_s.strip()
API = ENV['POPCLIP_OPTION_APIKEY'].to_s.strip()

short = JSON.parse(Net::HTTP.get('s.dev', '/api?api=' + API + '&url=' + input))
if short["error"] == 0 then
  print short["short"]
else
  print "An error happened:  "
  print short["error"]
  print "\n"
end

新しい拡張機能をロードすると、APIキーを要求されます。 APIキーを指定したら、 OKを押します。 、PopClipで使用できます。

リンクを選択すると、PopClipが開き、オプションのリストが表示されます。次に、短縮者を選択します オプション。しばらく考えてから、適切な短縮URLを貼り付けます。完全な拡張機能は、このチュートリアルのダウンロードに含まれています。これで、さらに多くのことを実行する準備が整いました！

結論

プライベートURL短縮サービスを利用できるだけでなく、Dockerを使用してローカルコンテナーを実行する方法、使用するURLを追跡する簡単な方法、短縮リンクを作成する方法も理解できます。

RubyスクリプトはAlfred3で使用できます またはKeyboardMaestro 同じように。新しいサービスを使用して、他の機能を試してみてください。