********************************************************************************
   mpdweblink Readme
                                                                      2020.07.20
                                                              by.Mikio.Shiratori
********************************************************************************

<mpdweblink>mpdwebの支援ソフト
URLに変数を与えて設定して,Web参照を行う一連のアプリケーションとなっている
別DNSはフレームで表示はできない仕様になっているので,Shellでアクセスした結果をフレームに表示することも行う。
フレームは全て対応してはいないのであくまで簡易表示としての扱いになる。

1. 実行環境として
LinixPackage:cURL    : Volumioを使用する場合はVolumioに含まれている。なければインストールする。
                       shellのみ(Libraryは使用しない)なので
                         # apt-get install -y curl

mpdweb      :mpdtask : 実行環境がlocalのみであれば使用しないが他の環境からURL取得を実行する場合は,mpdtaskを使用する
                       別環境でURL取得を実行するPCに設定しておく。

addin       :jquery  : mpdframe_extend.phpを使用するとFrameのResizeできるがjqueryを使用している(本パッケージにはjqueryも含まれる)

2. 使用前提
  初期としてフレームを生成しておく
<?php
 require_once("./mpdweblink/mpdframe.php");
 FrmView_Init("html");
 ?>

3. 参考
・curlテスト方法
 $ curl -fsSL {URL}
  Terminalに実行結果が表示される。
  httpsに接続できない場合
   TLS1.2を使えるライブラリに更新すると使用できるかもしれない(古い環境はまず実行できない)
   方法など調べてください

・curlでCacheする機能:放置するとmemoryを使用 NSS_SDB_USE_CACHEをYESかNOにするとsdb_measureAccessを呼ばなくなる

 インストール時に実行かキャッシュの増加が気になる場合に実行
 Cache Clear
  $ sudo sh -c "sync; echo {Cache} > /proc/sys/vm/drop_caches"
    Cache: 1:Page Cache
           2:Slab Cache
           3:Page/Slab

 環境変数の設定
  $ export NSS_SDB_USE_CACHE=YES

 Cache確認
  $ free -m

 phpで設定する場合は,
    php関数: putenv("NSS_SDB_USE_CACHE=YES");
 で行うが,当アプリでは埋め込んでいないのでLinux Shellで行う。

 ※ 配布版,XML設定で,Shellに設定している

4. 単体でmpdweblink関連をテストする場合のURL,
・mpdweblink.php:URL選択画面
  http://{Server}/mpdweb/mpdweblink/mpdweblink.php?search=Artist:{name};Album:{album}
  例) http://volumio.local:88/mpdweb/mpdweblink/mpdweblink.php?use=mpdweb&search=Artist:ANMI2;Album:Paper Plane

・mpdgethtml.php:URL実行
  http://{Server}/mpdweb/mpdweblink/mpdgethtml.php?shell={XML:shell設定}&emsg={XML:Error参照設定&url={実行URL}
  例) http://volumio.local:88/mpdweb/mpdweblink/mpdgethtml.php?shell=curl&emsg=HTTP&url=https://www.last.fm/ja/music/ANMI2/+wiki
  例) http://volumio.local:88/mpdweb/mpdweblink/mpdgethtml.php?shell=curl&service=Last.fm&emsg=HTTP&url=https://www.last.fm/ja/music/ANMI2/+wiki

