Blog

yourls APIを使って最速で短縮URL作るBash関数を作る

    >

プログラミングは、進む時は面白いぐらいに進むのに、詰まる時はとことん詰まる。そしてそのままフェードアウト…といったことはよく聞く話です。僕もHTMLから始めて、長いことプログラミングを続けてきましたが、どうしても自分の思い通りにいかない、実装ができない、エラーが続く、といった状況に悩まされ、うつ状態になり、もういっそプログラミングなんて辞めてしまおうか…と挫折しそうになった経験が、幾度となくあります。

プログラミングを6年続けてきて、プログラミングは自分一人で完結できるものではない、ということは痛いほど分かっています。"スタックオーバーフロー"だけではどうしようもないことも、中にはあります。 特に、新しい技術や言語に挑戦しようとする時は、難関が数多くあります。JavaとPHPは違いますし、スマホアプリが作れるからと言ってPythonができるとは限りません。多くの場合、多くの障壁に立ち塞がることでしょう。

実際、僕も多くのプログラミングをしている友人から、あらゆる相談を受けます。既存の回答や僕の知識から、最適な答えを返してあげられることもありますが、答えられないことや上手く説明できないことも多くあります。
そのような場合、僕が彼らに勧めているのが、『TechAcademy [テックアカデミー]』です。

同サービスは短期間から登録できるオンライン完結のプログラミングスクールで、他社と比較しても、そのコストパフォマンスは圧倒的です。
例えば、A社は148,000円〜のところ、同サービスは99,000円〜でコースが受講できます。( ※はじめてのプログラミングコース4週間の料金 )
また、一言に現役のプロと言っても、エンジニア歴20年以上、プログラム歴35年以上といった、まさにプロ中のプロの方たちが対応してくれるのも、『techacademy』の魅力の一つ。

国内外どこからでもチャット相談が可能で、毎日8時間、1週間あたり57時間の間、メンターが常時待機しています。
受講生限定の転職サポートで、コース受講終了後、企業やコンサルタントからスカウトが届く"TechAcademyキャリア"も、ぜひ活用したいところです。

  • オリジナルアプリをAppStoreにリリースするまで徹底サポート「iPhoneアプリコース」
  • 職業を問わず身につけたい、教養としてのプログラミングが学べる「はじめてのプログラミングコース」
  • 仮想通貨を支えるブロックチェーン技術の仕組みを学べる「ブロックチェーンコース」
  • Pythonと機械学習が学べる「Pythonコース」

『techacademy』では、上記コースをはじめとした、数多くの特化したコースが受講受付中です。プログラミングの進捗に真剣に悩んでいる方は、ぜひご活用ください。

TechAcademy [テックアカデミー]

さて、おまたせしました。

今回の記事は『yourls APIを使って最速で短縮URL作るBash関数を作る』です。この記事が役に立った、と思ったらぜひ、コメントまたはTwitterやLINEでシェアしてくださいね。

こんな感じです。

yuis@DESKTOP-UHU8FSH:/mnt/c/pg$ yourls "fumiya.org/hogefuga"
yuis@DESKTOP-UHU8FSH:/mnt/c/pg$ getredirected https://114514.click/20190104220817bp5by
http://fumiya.org/hogefugayuis@DESKTOP-UHU8FSH:/mnt/c/pg$
yuis@DESKTOP-UHU8FSH:/mnt/c/pg$ # https://114514.click/20190104220817bp5by
yuis@DESKTOP-UHU8FSH:/mnt/c/pg$
yuis@DESKTOP-UHU8FSH:/mnt/c/pg$

https://yuis.xsrv.jp/images/ss/ShareX_ScreenShot_41231405-9ccc-4b9d-9010-57863ce5d19a.gif

ここにAPIの雛形があります。

Remote API · YOURLS/YOURLS Wiki

yourlsのインストールは前提です。yourlsのインストールとかは当ブログでも解説記事がありますのでそちらをご参照ください。

では、簡単な解説。

/mnt/c/pg/yourls-api.phpを作ります。で、以下をコピペ。EDIT THISのうち、username,password,api_urlを各自入れてください。ユーザー名とパスワードは、user/config.phpに書いてあります。adminにログインするのに必要な情報です。もしパスワードがわからなければ、user/config.phpのpasswordが暗号化されているので、消して新しいパスワードにして上書き保存してやればいいです。

<?php

///////////////////////////////////////////////////////////////////
/////////////////////////// CONFIGURATION /////////////////////////
///////////////////////////////////////////////////////////////////

// C:\pg\yourls-api.php http://fumiya.org/hoge01 keyword title
// php yourls-api.php http://fumiya.org/hoge01 keyword title


// EDIT THIS: your auth parameters
$username = '';
$password = '';

// EDIT THIS: the query parameters
$url     = $argv[1] ; // 'http://fumiya.org/'; // URL to shrink $1
$keyword = $argv[2] ; // 'plaindate+random6';                        // optional keyword
$title   = $argv[3] ; // 'ad::aliexpress'; // $2 (d=no-title)               // optional, if omitted YOURLS will lookup title with an HTTP request
$format  = 'json';                       // output format: 'json', 'xml' or 'simple'

// EDIT THIS: the URL of the API file
$api_url = 'http://yourdomain.com/yourls-api.php';


///////////////////////////////////////////////////////////////////
///////////////////////////// SCRIPTS /////////////////////////////
///////////////////////////////////////////////////////////////////


// Init the CURL session
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $api_url );
curl_setopt( $ch, CURLOPT_HEADER, 0 );            // No header in the result
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true ); // Return, do not echo result
curl_setopt( $ch, CURLOPT_POST, 1 );              // This is a POST request
curl_setopt( $ch, CURLOPT_POSTFIELDS, array(      // Data to POST
        'url'      => $url,
        'keyword'  => $keyword,
        'title'    => $title,
        'format'   => $format,
        'action'   => 'shorturl',
        'username' => $username,
        'password' => $password
    ) );

// Fetch and return content
$data = curl_exec($ch);
curl_close($ch);

// Do something with the result. Here, we just echo it.
echo $data;

この時点で、cd /mnt/c/pg/ && php yourls-api.php http://fumiya.org/hoge01 keyword titleといった感じで正常に動くかテストしておきましょう。curlの結果としてjsonが返ってきますが、エラーなどが含まれていないか確認しましょう。

Uncaught Error: Call to undefined function curl_init()ってエラーが出る場合があります。

php – Fatal error: Call to undefined function curl_init() in … on line 9 – Stack Overflow

windowsならphp.iniをいじるらしいですが、ubuntu16.04とかなら、sudo apt install php-curlしてやると僕は治りました。

はい。で、関数定義します。以下。(.bashrc)

先程のメインPHPファイルに引数を渡しつつ、結果として返ってくるjsonをpythonでパースして、shorturlを取得。shorturlは完成した短縮URLになります。でさらに、clip.exeに渡してクリップボードにコピーしています。

yourls(){
  url=$1
  keyword="$(plaindate)$(random 6)"
  title=$2
  php /mnt/c/pg/yourls-api.php "$url" "$keyword" "$title" | python3 -c 'import json,sys;print(json.load(sys.stdin)["shorturl"])' | clip.exe
}

使いかた:

yourls [短縮したいURL] [タイトル*1]

1: adminに表示される。検索する時にあると便利。

e.g. yourls "fumiya.org/hogefuga"
e.g. yourls "fumiya.org/hogefuga" "hogefuga"

adminパネルにはこんな感じで表示されます。

https://yuis.xsrv.jp/images/ss/ShareX_ScreenShot_08dfe367-161d-49f5-8d89-034b43905c87.png

ここでは紹介していないplaindate,random,getredirectedなどの関数については僕の.bashrcに定義してあります。.bashrcは僕の[github]で公開しています。(検索して見つけてください。)

plaindate はじめてのBash。関数やエイリアスを読み込むまで [初心者向け] 

  plaindate(){
    date '+%Y%m%d%H%M%S'
  }

2020年の東京五輪を間近に控え、来日外国人の数は年々増加しています。ただでさえ、あらゆる職種で"英語力"が求められる時代ですが、その中でも特筆してプログラマ、システムエンジニアには、英語力は必須であると言われています。

僕は現在、英検1級に着手し、英語力が一定水準に達した今でも、日々新しい表現や単語を学んでいます。しかし僕も最初から英語が出来たわけではありません。中学生の頃の英語の成績は、学年でほぼビリでしたし、そもそも英語なんて必要ない（若者の常套句ですね）、今後一生やることはない、と思っていたくらいです。

確かに、英語を使わずとも年収600万以上の仕事に就くことは出来ますし、生活する上で困ることもないでしょう。しかしそれは、英語を知っている世界を知らないからでしかありません。
英語に興味関心がない多くの方は、こういうことを言うと反発するのですが、プログラミング経験者の皆さんなら、そうでもないのではないでしょうか。

プログラミングをやっていて、英語が出来たらなぁと思ったこと、あるのではないでしょうか。僕が英語を始めた動機は他にありますが、一度、二度挫折した英語学習を再開する動機となったのは、紛れもなく、"プログラミング"でした。プログラミングを続けるには、英語の壁を超える必要がある、と幾度となく痛感しました。

  • エラー文章をGoogle検索せずとも理解できる
  • ソースコードに日本語が含まれる場合に起こる特有のエラーを回避できる
  • スタックオーバーフローの回答が理解できる
  • スタックオーバーフローに質問を投稿し、良質で的を射た回答を得ることができる
  • 翻訳されていないドキュメントやリファレンスを理解できる
  • 適切なメソッド名やファイル名をスムーズに定義できる
  • 需要が高く報酬の良い海外で仕事が探せる、または海外のクライアントを相手にできる

上記をはじめとした、プログラミングにおいて英語ができることのメリットは数多く存在します。
英語学習の必要性に疑問を持っていた方も、上記の一覧を見て、何か思うことがあるかもしれません。しかし、英語を学習する意義を見つけたあと、間違っていけないのが、その学習方法です。

英語学習方法には効率的、非効率的、意味がないなど、様々な方法が乱立しています。中には悪徳なものもあり、注意が必要です。
英語学習に回り道やチートはありませんが、効率的でない学習方法を避けて学習を進めていくことは、1年後、5年後の自分の英語力に取り返しのつかない差が開いてしまうことを未然に防ぎます。

そして、僕が一番信頼を置いているのが、『スタディサプリ ENGLISH』です。『スタディサプリ ENGLISH』はこれまで様々な英語に関する相談をしてきた友人への、最も勧める頻度の高かったサービスです。

留学が間近で…、ワーキングホリデーに行ってみたくて…、やっぱり英語をまた始めようと思って…、社内公用語対策で…、英会話教室に通おうと思ってて…などなど、僕への相談は様々ですが、これら全ての方に、『スタディサプリ ENGLISH』は自信を持っておすすめできます。

スタディサプリ ENGLISH

さて、最後までお読み頂きありがとうございました。この記事が役に立った、と思ったらぜひ、コメントまたはTwitterやLINEでシェアしてくださいね。

僕は個人事業として、プログラミング6年、1日14時間パソコン業務をこなしてきました。現在もウェブサイト開発やサポート、ソフトウェア制作、レビューなどライティングをはじめとしたお仕事を承っております。気になったらぜひ、メールにてご連絡ください。いつでもお待ちしております。

現在承っているお仕事の一覧
お問い合わせ

小山はるや(こやまはるや) 東京生まれ。プログラマー。現役大学生。ウェブサイト制作の傍らメディア運営を行い、2017年に開設されたITブログ『yuipro』(https://yuis-programming.com)は2019年に月間アクセス数1万を超える。 これまで80を超えるウェブサイトを制作、小山氏自ら運営するウェブサイトは8つに上り、うち2つが月当たり数万のアクティブビジターを獲得している。

Close Menu