目次
サンプル・プログラムの実行例
サンプル・プログラム
| searchNDL.php | サンプル・プログラム本体 |
WebAPI：国立国会図書館サーチ（OpenSearch）
| URL |
|---|
| https://iss.ndl.go.jp/api/opensearch |
| フィールド名 | 要否 | 内 容 |
|---|---|---|
| title | いずれか | 書名、記事名など。UTF-8エンコード。部分一致。 |
| creator | いずれか | 著者、編者など。UTF-8エンコード。部分一致。 |
| publisher | いずれか | 出版社。UTF-8エンコード。部分一致。 |
| ndc | いずれか | NDC分類。前方一致。 |
| from | 任意 | 検索を開始する出版年月日。YYYY-MM-DD。 |
| until | 任意 | 検索を終了する出版年月日。YYYY-MM-DD。 |
| cnt | 任意 | 取得する検索結果の件数。省略時は200。一度に取得できる最大件数は500。 |
| isbn | いずれか | ISBNコード。10桁または13桁。前方一致。 |
| mediatype | 任意 | 資料種別 “1”：本 “2”：記事・論文 “3”：新聞 “4”：児童書 “5”：レファレンス情報 “6”：デジタル資料 “7”：その他 “8”：障害者向け資料（障害者向け検索対象資料） “9”：立法情報 |
解説：初期値設定
0015: define('INTERNAL_ENCODING', 'UTF-8');
0016: mb_internal_encoding(INTERNAL_ENCODING);
0017: mb_regex_encoding(INTERNAL_ENCODING);
0018: define('MYSELF', basename($_SERVER['SCRIPT_NAME']));
0019: define('REFERENCE', 'https://www.pahoo.org/e-soul/webtech/php06/php06-37-01.shtm');
0020: define('TITLE', '国立国会図書館サーチ');
0021:
0022: //リファラチェック＋リリースフラグの設定
0023: if (isset($_SERVER['HTTP_HOST']) && ($_SERVER['HTTP_HOST'] == 'localhost')) {
0024: define('FLAG_RELEASE', FALSE);
0025: define('REFER_ON', '');
0026: ini_set('display_errors', 1);
0027: ini_set('error_reporting', E_ALL);
0028: } else {
0029: //リリース・フラグ（公開時にはTRUEにすること）
0030: define('FLAG_RELEASE', TRUE);
0031: //リファラ・チェック（直リン防止用；空文字ならチェックしない）
0032: define('REFER_ON', 'www.pahoo.org');
0033: }
0034:
0035: //入力バリデーション
0036: define('QUERY_MIN', 2); //検索文字列の最短
0037: define('QUERY_MAX', 40); //検索文字列の最長
0038:
0039: //表示幅（ピクセル）
0040: define('WIDTH', 600);
0041:
0042: //TRUE：書名読みがなを表示する／FALSE：表示しない
0043: define('RUBY', TRUE);
0044:
0045: //国立国会図書館サーチAPI（変更不可）
0046: define('NDL_URL', 'https://iss.ndl.go.jp/api/opensearch');
定数 RUBY は、書名読みがな（応答データの dcndl:titleTranscription 要素の内容）を ruby タグを使って表示するか否かのフラグである。
解説：リクエストURL取得
0286: /**
0287: * 国立国会図書館サーチAPI のURLを取得する
0288: * @param string $query タイトル（UTF-8；部分一致）
0289: * またはISBN（10桁または13桁；完全一致または前方一致）
0290: * 【省略不可】
0291: * @param string $creater 作成者（UTF-8；部分一致）
0292: * @param string $from 開始出版年月日（YYYY-MM-DD）
0293: * @param string $until 終了出版年月日（YYYY-MM-DD）
0294: * @param int $cnt 出力レコード上限値（省略時=50）
0295: * @param int $mediatype 資料種別（省略時=2:本)
0296: * @return string WebAPI URL
0297: */
0298: function getURL_searchNDL($query, $creater='', $from='', $until='', $cnt=50, $mediatype='1') {
0299: $isbn = '';
0300: if (preg_match('/^[0-9|\-]+$/', $query) == 1) {
0301: $title = '';
0302: $isbn = 'isbn=' . preg_replace('/\-/', '', $query);
0303: }
0304: if ($isbn == '') {
0305: $title = 'title=' . urlencode($query);
0306: }
0307:
0308: $creater = ($creater != '') ? '&creater=' . urlencode($creater) : '';
0309: $from = ($from != '') ? '&from=' . $from : '';
0310: $until = ($until != '') ? '&until=' . $until : '';
0311: $cnt = ($cnt > 0) ? '&cnt=' . $cnt : '';
0312: $mediatype = ($mediatype != '') ? '&mediatype=' . $mediatype : '';
0313:
0314: return NDL_URL . '?' . $title . $isbn . $creater . $from . $until . $cnt . $mediatype;
0315: }
タイトルには、書名と ISBN のいずれかを指定可能だ。ユーザー関数内で、数値とハイフンならば ISBN として認識する。
また、タイトル以外は省略可能にしてある。
解説：国立国会図書館検索
0317: /**
0318: * 国立国会図書館サーチAPIを呼び出し結果を配列に格納する
0319: * @param array $items 書籍情報格納用
0320: * @param string $errmsg エラーメッセージ格納用
0321: * @param string $query タイトル（UTF-8；部分一致）
0322: * またはISBN（10桁または13桁；完全一致または前方一致）
0323: * 【省略不可】
0324: * @param string $creater 作成者（UTF-8；部分一致）
0325: * @param string $from 開始出版年月日（YYYY-MM-DD）
0326: * @param string $until 終了出版年月日（YYYY-MM-DD）
0327: * @param int $cnt 出力レコード上限値（省略時=50）
0328: * @param int $mediatype 資料種別（省略時=2:本)
0329: * @return int 検索結果の件数
0330: */
0331: function searchNDL(&$items, &$errmsg, $query, $creater='', $from='', $until='', $cnt=50, $mediatype='1') {
0332: //名前空間
0333: define('NS_DCMITYPE', 'http://purl.org/dc/dcmitype/');
0334: define('NS_RDFS', 'http://www.w3.org/2000/01/rdf-schema#');
0335: define('NS_XSI', 'http://www.w3.org/2001/XMLSchema-instance');
0336: define('NS_OPENSEARCH', 'http://a9.com/-/spec/opensearchrss/1.0/');
0337: define('NS_DC', 'http://purl.org/dc/elements/1.1/');
0338: define('NS_DCNDL', 'http://ndl.go.jp/dcndl/terms/');
0339: define('NS_RDF', 'http://www.w3.org/1999/02/22-rdf-syntax-ns#');
0340: define('NS_RCTERMS', 'http://purl.org/dc/terms/');
0341:
0342: $errmsg = '';
0343: $url = getURL_searchNDL($query, $creater, $from, $until, $cnt, $mediatype);
0344:
0345: //PHP4用; DOM XML利用
0346: if (isphp5over() == FALSE) {
0347: if (($dom = read_xml($url)) == NULL) {
0348: $errmsg = '国立国会図書館サーチAPIの接続に失敗しました．';
0349: return (-1);
0350: }
0351: $rss = $dom->get_elements_by_tagname('rss');
0352: $channel = $rss[0]->get_elements_by_tagname('channel');
0353: $arr = $channel[0]->get_elements_by_tagname('item');
0354: //レスポンス・チェック
0355: $count = count($arr);
0356: if ($count <= 0) {
0357: $errmsg = '検索結果がありません．';
0358: return (-1);
0359: }
0360: $cnt = 0;
0361: foreach ($arr as $item) {
0362: //ISBN，書名，著者，出版社，NDC番号，URL，出版日
0363: $isbn = '';
0364: $node = $item->get_elements_by_tagname('identifier');
0365: foreach ($node as $val) {
0366: if (preg_match('/ISBN/iu', (string)$val->get_attribute('type')) == 1) $isbn = (string)$val->get_content();
0367: }
0368: if ($isbn == '') continue;
0369: $node = $item->get_elements_by_tagname('title');
0370: if ($node == NULL) {
0371: $items[$isbn]['title'] = '';
0372: } else if ((string)$node[0]->get_content() != '') {
0373: $items[$isbn]['title'] = (string)$node[0]->get_content();
0374: } else if (! isset($items[$isbn]['title'])) {
0375: $items[$isbn]['title'] = '';
0376: }
0377: $node = $item->get_elements_by_tagname('creator');
0378: if ($node == NULL) {
0379: $items[$isbn]['author'] = '';
0380: } else if ((string)$node[0]->get_content() != '') {
0381: $items[$isbn]['author'] = (string)$node[0]->get_content();
0382: } else if (! isset($items[$isbn]['author'])) {
0383: $items[$isbn]['author'] = '';
0384: }
0385: $node = $item->get_elements_by_tagname('publisher');
0386: if ($node == NULL) {
0387: $items[$isbn]['publisher'] = '';
0388: } else if ((string)$node[0]->get_content() != '') {
0389: $items[$isbn]['publisher'] = (string)$node[0]->get_content();
0390: } else if (! isset($items[$isbn]['publisher'])) {
0391: $items[$isbn]['publisher'] = '';
0392: }
0393: $items[$isbn]['NDC'] = '';
0394: $node = $item->get_elements_by_tagname('subject');
0395: foreach ($node as $val) {
0396: if (preg_match('/NDC/iu', (string)$val->get_attribute('type')) == 1) $items[$isbn]['NDC'] = (string)$val->get_content();
0397: }
0398: $node = $item->get_elements_by_tagname('link');
0399: if ($node == NULL) {
0400: $items[$isbn]['url'] = '';
0401: } else if ((string)$node[0]->get_content() != '') {
0402: $items[$isbn]['url'] = (string)$node[0]->get_content();
0403: } else if (! isset($items[$isbn]['url'])) {
0404: $items[$isbn]['url'] = '';
0405: }
0406: $node = $item->get_elements_by_tagname('pubDate');
0407: if ($node == NULL) {
0408: $items[$isbn]['pubDate'] = '';
0409: } else if ((string)$node[0]->get_content() != '') {
0410: $items[$isbn]['pubDate'] = (string)$node[0]->get_content();
0411: } else if (! isset($items[$isbn]['pubDate'])) {
0412: $items[$isbn]['pubDate'] = '';
0413: }
0414: $node = $item->get_elements_by_tagname('volume');
0415: if ($node != NULL) {
0416: $items[$isbn]['title'] = $items[$isbn]['title'] . '（' . (string)$node[0]->get_content() . '）';
0417: }
0418: $node = $item->get_elements_by_tagname('titleTranscription');
0419: if ($node != NULL) {
0420: $str = (string)$node[0]->get_content();
0421: $str = preg_replace('/[ ]/ui', '', $str);
0422: $str = mb_convert_kana($str, 'c');
0423: } else {
0424: $str = '';
0425: }
0426: $items[$isbn]['yomi'] = $str;
0427: $cnt++;
0428: }
0429:
0430: //PHP5用; SimpleXML利用
0431: } else {
0432: $xml = @simplexml_load_file($url);
0433: if ($xml == FALSE) {
0434: $errmsg = '国立国会図書館サーチAPIの接続に失敗しました．';
0435: return FALSE;
0436: }
0437: //レスポンス・チェック
0438: $count = @count($xml->channel->item);
0439: if ($count <= 0) {
0440: $errmsg = '検索結果がありません．';
0441: return (-1);
0442: }
0443: $cnt = 0;
0444: foreach ($xml->channel->item as $item) {
0445: //ISBN，書名，著者，出版社，NDC番号，URL，出版日
0446: $node = $item->children(NS_DC);
0447: $isbn = '';
0448: foreach ($node->identifier as $id) {
0449: if (preg_match('/ISBN/iu', (string)$id->attributes(NS_XSI)) == 1) $isbn = (string)$id;
0450: }
0451: if ($isbn == '') continue;
0452: if ((string)$node->title != '') {
0453: $items[$isbn]['title'] = (string)$node->title;
0454: } else if (! isset($items[$isbn]['title'])) {
0455: $items[$isbn]['title'] = '';
0456: }
0457: if ((string)$node->creator != '') {
0458: $items[$isbn]['author'] = (string)$node->creator;
0459: } else if (! isset($items[$isbn]['author'])) {
0460: $items[$isbn]['author'] = '';
0461: }
0462: if ((string)$node->publisher != '') {
0463: $items[$isbn]['publisher'] = (string)$node->publisher;
0464: } else if (! isset($items[$isbn]['publisher'])) {
0465: $items[$isbn]['publisher'] = '';
0466: }
0467: $items[$isbn]['NDC'] = '';
0468: foreach ($node->subject as $id) {
0469: if (preg_match('/NDC/iu', (string)$id->attributes(NS_XSI)) == 1) $items[$isbn]['NDC'] = (string)$id;
0470: }
0471: if ((string)$item->link != '') {
0472: $items[$isbn]['url'] = (string)$item->link;
0473: } else if (! isset($items[$isbn]['url'])) {
0474: $items[$isbn]['url'] = '';
0475: }
0476: if ((string)$item->pubDate != '') {
0477: $items[$isbn]['pubDate'] = (string)$item->pubDate;
0478: } else if (! isset($items[$isbn]['pubDate'])) {
0479: $items[$isbn]['pubDate'] = '';
0480: }
0481: //巻数，書名読みがな
0482: $node = $item->children(NS_DCNDL);
0483: if ($node->volume != '') {
0484: $items[$isbn]['title'] = $items[$isbn]['title'] . '（' . (string)$node->volume . '）';
0485: }
0486: $str = (string)$node->titleTranscription;
0487: $str = preg_replace('/[ ]/ui', '', $str); //空白除去
0488: $str = mb_convert_kana($str, 'c'); //カタカナ→ひらがな変換
0489: $items[$isbn]['yomi'] = $str;
0490: $cnt++;
0491: }
0492: }
0493:
0494: return $cnt;
0495: }
サンプル・プログラムでは、引数 $query にタイトルまたは ISBN を渡すことで検索を行う。$creater 以降の引数はデフォルト値のままにしてあるが、ぜひ、これらの引数を利用したプログラムを作ってみてほしい。
検索結果の XML 構造は RSS 2.0 に似ており、PHP5（SimpleXML）では名前空間に注意が必要だ。名前空間については「PHP でコロンを含む XML要素名を扱う方法」を参照のこと。ここでは、各々の名前空間を定数で定義している。
検索結果の ISBN から ASIN を求め Amazon へのリンクを張る部分は、「PHP で ISBN コードを ASIN コードに変換する」のサンプル・プログラムを流用している。
エラーが発生した場合、引数 $errmsg にエラーメッセージを格納する。エラーがなければ空文字を代入する。
質疑応答
「PHP で国立国会図書館を検索」のページ大変参考になります。使用させていただきたいと思っています。
ところで、本のタイトルの読みは XML では <dcnl:titleTranscription> とあるのですが、上記の PHP でフリガナの取得はできないのでしょうか。どのようにすれば可能なのでしょうか?教えていただけませんか。
本のサイズ<extent>は何とか取得することができたのですが。
<dc;title>などと <dcnl:titleTranscription> などとの記述の違いが判りません。
教えていただけるとありがたいのですが。
【回答】
お気づきのように、WebAPI の応答にある <dcnl:titleTranscription> に書名の読み仮名（全角カタカナ）が入っています。
読みがなを含めて取得・表示するようプログラムを改良しました。お試しください。
【質問】
ルビ入りのプログラムを作成くださりありがとうございます。参考にさせていただきます。
今後ともよろしくお願いいたします。
【回答】
どういたしまして😀
ご活用ください。
【質問】
たびたびお世話になります。
貴重なプログラムなので活用させていただいています。
「鬼滅の刃」を検索すると著者名まで表示されるのですが、その中の１つの ISBN で検索してみると、それでは著者名が表示されません。
どうしてそのような違いが生じるのか、よくわかりません。はじめはそのデータが登録されていないのかと同様のことをいろいろやってみても同じような状況になります。コミックだからでしょうか。
author creator 違いなのかと代えてもみても、うまくいきません。
author を使用するところと creator を使用する個所とがあるのでしょうか。
【回答】
ISBN で検索する場合、ISBN が単一（1 つの書籍）であるにもかかわらず、複数の結果が還ってくることがあります。どうやら国立国会図書館サーチの仕様のようです。
そこで、複数の結果が返ってきたときは、一番最後の有効な値を表示するようにプログラムを改良しました。
ここで、「ISBN＝9784088812830」（『鬼滅の刃』第9 巻）を検索すると、書名に「遊郭潜入大作戦」と表示されます。これは、国立国会図書館サーチが返す複数の結果の最後が、書名にサブタイトルが入っているためです。いまのところ、書名なのかサブタイトルなのかを判断する情報がないため、プログラムの改良はここまでとします。
参考サイト
- 国立国会図書館サーチ
- PHP で Windows用国立国会図書館検索プログラムをつくる：ぱふぅ家のホームページ
- C++で国立国会図書館検索：ぱふぅ家のホームページ
- PHP でコロンを含む XML要素名を扱う方法：ぱふぅ家のホームページ
- PHP で ISBN コードを ASIN コードに変換する：ぱふぅ家のホームページ
- PHP で楽天ブックス API を使って書籍検索：ぱふぅ家のホームページ
また、「PHP で Windows用国立国会図書館検索プログラムをつくる」や「C++で国立国会図書館検索」では、このプログラムを Windows アプリに移植したので参考にされたい。
（2021 年 1 月 18 日）ISBN 検索時に情報不足になることがあり回避策追加。
（2021 年 1 月 6 日）書名読みがな追加，一覧表スタイル変更，PHP8 対応，エラー処理の厳格化