使用 curl 指定 Server IP 檢驗 SSL 憑證 (SKIP DNS LOOKUP)

原先是想要做 curl -I https://IP 檢驗時，在想怎樣處理憑證檢驗，像是多塞 "Host: test.com" 是不是有用，最後查了一下，要反過來想，可以多增加 --resolve 參數去指定，如此就可以測試指定的機器了

% man curl 

...

       --resolve <[+]host:port:addr[,addr]...>

              Provide a custom address for a specific host and port pair. Using this, you can make the curl requests(s) use a specified

              address and prevent the otherwise normally resolved address to be used. Consider it a sort of /etc/hosts alternative

              provided on the command line. The port number should be the number used for the specific protocol the host will be used for.

              It means you need several entries if you want to provide address for the same host but different ports.

              By specifying '*' as host you can tell curl to resolve any host and specific port pair to the specified address. Wildcard is

              resolved last so any --resolve with a specific host and port will be used first.

              The provided address set by this option will be used even if --ipv4 or --ipv6 is set to make curl use another IP version.

              By prefixing the host with a '+' you can make the entry time out after curl's default timeout (1 minute). Note that this

              will only make sense for long running parallel transfers with a lot of files. In such cases, if this option is used curl

              will try to resolve the host as it normally would once the timeout has expired.

              Support for providing the IP address within [brackets] was added in 7.57.0.

              Support for providing multiple IP addresses per entry was added in 7.59.0.

              Support for resolving with wildcard was added in 7.64.0.

              Support for the '+' prefix was was added in 7.75.0.

              This option can be used many times to add many host names to resolve.

              Example:

               curl --resolve example.com:443:127.0.0.1 https://example.com

              See also --connect-to and --alt-svc.

這用法可以用在 load balancer 或 GeoDNS 後面的機器群測試，也能拿來測試某機器的 SSL 憑證是否設定正常。

[Linux] 使用 uClibc-ng 製作 x86_64 開發測試環境，以編譯 curl / libcurl 為例 @ Ubuntu 20.04

由於硬體要限縮資源，這時會把常見的 glibc 換成 uclibc 節省空間，而過程包括要建置 toolchain 等等。由於部分程式在 embedded linux 運作不如預期，大家擔心可能是 uclibc 產生的問題，就出現在 x86_64 運行 uclibc 作檢驗的念頭

實作上也是要建置 x86_64 的 toolchain 出來，此例就用 curl / libcurl 為例。此篇工作記錄參考 编译工具链制作-x86_64-linux-uclibc 文章，建議先拜讀這篇，裡頭編譯參數的項目都有說明，佛心啊。此處筆記是設法把開發環境都用最新環境，包括：

• Ubuntu 20.04.1 LTS server
• uClibc-ng-1.0.36
• binutils-2.35
• gcc-9.3.0 
• mpfr-4.1.0
• mpc-1.2.1 
• gmp-6.1.2
• linux-2.6.39

而後面編譯 curl 採用以下資源：

• tiny-curl-7.72.0
• zlib-1.2.11
• openssl-1.1.1h 

採用 gcc-9.3.0 的主因是 ubuntu 20.04 預設 apt install gcc 就是 9.3 版。以下連續動作：

$ wget https://ftp.gnu.org/gnu/binutils/binutils-2.35.tar.gz
$ wget https://ftp.gnu.org/gnu/gcc/gcc-9.3.0/gcc-9.3.0.tar.gz
$ wget https://ftp.gnu.org/gnu/gmp/gmp-6.1.2.tar.bz2
$ wget https://ftp.gnu.org/gnu/mpc/mpc-1.2.1.tar.gz
$ wget https://ftp.gnu.org/gnu/mpfr/mpfr-4.1.0.tar.gz
$ wget http://ftp.ntu.edu.tw/linux/kernel/v2.6/linux-2.6.39.tar.gz
$ wget https://downloads.uclibc-ng.org/releases/1.0.36/uClibc-ng-1.0.36.tar.gz

並全在 user 家目錄解壓縮，解壓縮後把 open source 包都移到 resource 目錄中保存：

user@buildserver:~$ tree -L 1 
.
├── binutils-2.35
├── gcc-9.3.0
├── gmp-6.1.2
├── linux-2.6.39
├── mpc-1.2.1
├── mpfr-4.1.0
├── resource
└── uClibc-ng-1.0.36

安裝一些工具：

$ sudo apt install make cmake gcc g++ libncurses-dev libncurses5-dev
$ gcc -v
...
Thread model: posix
gcc version 9.3.0 (Ubuntu 9.3.0-17ubuntu1~20.04) 
$ g++ -v
...
Thread model: posix
gcc version 9.3.0 (Ubuntu 9.3.0-17ubuntu1~20.04) 
$ make -v
GNU Make 4.2.1
Built for x86_64-pc-linux-gnu
$ cmake --version
cmake version 3.16.3

建置環境變數，預計都安裝在家目錄的 tarball 裡，此例就是 /home/user/tarball：

$ cat ~/uclibc-init.sh 
export ARCH=x86
export TARGET=x86_64-linux-uclibc
export PREFIX=/home/user/tarball
export TARGET_PREFIX=$PREFIX/$TARGET
export PATH=$PREFIX/bin:$PATH

 

$ source ~/uclibc-init.sh
$ mkdir -p $TARGET_PREFIX

編譯 binutils 環境：

$ cd binutils-2.35 && mkdir -p $TARGET && cd $TARGET
$ ../configure \
--prefix=$PREFIX \
--with-lib-path=$PREFIX/lib:$PREFIX/lib64 \
--disable-multilib \
--disable-werror \
--disable-nls \
--enable-gold \
--target=$TARGET
$ make && make install

 

$ x86_64-linux-uclibc-ld --verbose | grep SEARCH
SEARCH_DIR("/home/user/tarball/x86_64-linux-uclibc/lib64"); SEARCH_DIR("/home/user/tarball/lib"); SEARCH_DIR("/home/user/tarball/lib64"); SEARCH_DIR("/home/user/tarball/x86_64-linux-uclibc/lib");

這邊增加 --enable-gold 用於 gcc-9.3 的編譯時會踩到的需求，通常就是缺一些 header files 就是要找找看躲在 binutils, uclibc 等等

安置 linux header files：

$ linux-2.6.39/
$ make ARCH=$ARCH INSTALL_HDR_PATH=$TARGET_PREFIX headers_install

編譯跨平台 gcc 工具：

$ cd gcc-9.3.0/
$ ln -s ../mpc-1.2.1/ mpc
$ ln -s ../mpfr-4.1.0/ mpfr
$ ln -s ../gmp-6.1.2/ gmp
$ mkdir -p $TARGET && cd $TARGET
$ ../configure \
--prefix=$PREFIX \
--with-sysroot=$PREFIX \
--with-local-prefix=$PREFIX \
--with-native-system-header-dir=/$TARGET/include \
--enable-languages=c,c++ \
--enable-linker-build-id \
--disable-multilib \
--disable-werror \
--without-headers \
--with-newlib \
--disable-shared \
--disable-nls \
--target=$TARGET
$ make all-gcc
$ make install-gcc

安置 uclibc 相關檔案們(startfiles/headers)：

$ cd uClibc-ng-1.0.36
$ make menuconfig
Target Architecture
    --> x86_64
Target Architecture Features and Options
--> [*] Enable full C99 math library support  
--> [*] Enable C99 Floating-point environment
--> Linux kernel header location (/home/user/tarball/x86_64-linux-uclibc/include)
General Library Settings
--> [*] Dynamic linker stand-alone mode support
--> Thread support (Native POSIX Threading (NPTL))
--> [*] utmpx based support for tracking login/logouts to/from the system
--> [*]   utmp support (XPG2 compat, SVr4 compat) 
--> [*] Enable SuSv3 LEGACY functions
--> [*] Enable SuSv3 LEGACY macros
--> [*] Enable SuSv4 or obsolescent functions
Advanced Library Settings
--> [*] Enable SVr4 deprecated functions
Networking Support
--> [*] IP version 6 support
--> [*]   Use netlink to query interfaces 
--> [*]     Support the AI_ADDRCONFIG flag
--> [*] DNS resolver functions
String and Stdio Support
--> [*] Wide Charater Support
Big and Tall
--> [*] Support the wordexp() interface
Libray Installation Options
--> uClibc runtime library directory(/home/user/tarball/x86_64-linux-uclibc)
--> uClibc development envirment directory(/home/user/tarball/x86_64-linux-uclibc)
Development/debugging options
--> Cross-compiling toolchain prefix (x86_64-linux-uclibc-)
--> (-D__NR_setns -D__NR_syncfs) Extra CFLAGS
$ make startfiles
$ PREFIX="" make install_startfiles
$ PREFIX="" make install_headers

其中我開啟了不少項目都是後邊在編譯 gcc-9.3 和 curl 會用到的項目，像是缺 ifaddrs.h 而開啟 Support the AI_ADDRCONFIG flag 又相依要開啟 Use netlink to query interfaces 選項等等。過程常見的都是編譯期間缺 header files 而反覆在 uclibc 開啟資源，可以把缺的 header files 在 uclibc 中靠 find 或 grep 搜尋

繼續編譯跨平台 libgcc：

$ cd ~/gcc-9.3.0/$TARGET
$ make all-target-libgcc
$ make install-target-libgcc

編譯和安裝 uclibc ：

$ cd ~/uClibc-ng-1.0.36/
$ make
$ PREFIX="" make install

最後一次 gcc 編譯：

$ cd ~/gcc-9.3.0/$TARGET
$ ../configure \
--prefix=$PREFIX \
--with-sysroot=/ \
--with-local-prefix=$PREFIX \
--with-native-system-header-dir=$TARGET_PREFIX/include \
--enable-languages=c,c++ \
--enable-linker-build-id \
--disable-libsanitizer \
--disable-multilib \
--disable-werror \
--disable-nls \
--target=$TARGET
$ make all
$ make install

如此，就可以有基本的環境運行了，例如編譯 main.c：

$ cat main.c 
#include <stdio.h>
int main(int argc, char *argv[]) {
        printf("Hello\n");
        return 0;
}
$ x86_64-linux-uclibc-gcc main.c 
$ ./a.out 
-bash: ./a.out: No such file or directory
$ file a.out 
a.out: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib/ld64-uClibc.so.0, BuildID[sha1]=c243334b7550adf7ef5342019c444d6762da738b, not stripped

 

$ ~/tarball/x86_64-linux-uclibc/lib/ld64-uClibc-1.0.36.so --library-path /home/user/tarball/x86_64-linux-uclibc/lib/:/home/user/tarball/x86_64-linux-uclibc/lib64:/home/user/tarball/lib ./a.out
Hello

緊接著編譯 curl 來用，因為他相依 openssl, libssh2, zlib ，所以過程要先把這些函示庫都編好：

$ wget https://zlib.net/zlib-1.2.11.tar.gz
$ tar -xvf zlib-1.2.11.tar.gz && cd ~/zlib-1.2.11
$ CC=x86_64-linux-uclibc-gcc  CXX=x86_64-linux-uclibc-g++  ./configure --prefix=$PREFIX
$ make && make install  

 

$ wget https://www.libssh2.org/download/libssh2-1.9.0.tar.gz
$ tar -xvf libssh2-1.9.0.tar.gz && cd libssh2-1.9.0
$ CC=x86_64-linux-uclibc-gcc  CXX=x86_64-linux-uclibc-g++  ./configure --prefix=$PREFIX --host x86_64-linux-uclibc
$ make && make install

 

$ wget https://www.openssl.org/source/openssl-1.1.1h.tar.gz
$ tar -xvf openssl-1.1.1h.tar.gz && cd ~/openssl-1.1.1h
$ CC=x86_64-linux-uclibc-gcc  CXX=x86_64-linux-uclibc-g++ ./config --prefix=$PREFIX -latomic no-threads no-shared no-rc5  enable-camellia  enable-mdc2 no-tests no-fuzz-libfuzzer no-fuzz-afl zlib
$ make && make install

 

$ wget https://curl.haxx.se/tiny/tiny-curl-7.72.0.tar.gz
$ tar -xvf tiny-curl-7.72.0.tar.gz && cd tiny-curl-7.72.0
$ mkdir build && cd build
$ CC=x86_64-linux-uclibc-gcc CXX=x86_64-linux-uclibc-gc++ cmake .. -DCMAKE_PREFIX_PATH=~/tarball -DCMAKE_INSTALL_PREFIX=~/tarball
$ make && make install

 

$ /home/user/tarball/bin/curl
-bash: /home/user/tarball/bin/curl: No such file or directory
$ ~/tarball/x86_64-linux-uclibc/lib/ld64-uClibc-1.0.36.so --library-path /home/user/tarball/x86_64-linux-uclibc/lib/:/home/user/tarball/x86_64-linux-uclibc/lib64:/home/user/tarball/lib  /home/user/tarball/bin/curl --version
curl 7.72.0 (Linux) libcurl/7.72.0 OpenSSL/1.1.1h zlib/1.2.11 libssh2/1.9.0
Release-Date: 2020-08-27
Protocols: dict file ftp ftps gopher http https imap imaps pop3 pop3s rtsp scp sftp smb smbs smtp smtps telnet tftp
Features: AsynchDNS HTTPS-proxy IPv6 Largefile libz NTLM SSL UnixSockets

收工！

使用 curl 仿 DLNA controller 指令播放影片: DLNA protocol + SOAP protocol

大概去年就拿 DLNA 當做個小題目研究了一下，最近工作又需要，再度翻出來複習一下。使用了別人寫的 python 小工具，非常小巧精美：github.com/cherezov/dlnap

裝置搜尋:

$ python dlnap.py
No compatible devices found.
$ python dlnap.py
Discovered devices:
 [a] Name1 @ 192.168.1.2
 [a] Name2 @ 192.168.1.3

播放影片:

$ python dlnap.py -d Name1 --play http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
No compatible devices found.

$ python dlnap.py -d Name1 --play http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
Name1 @ 192.168.1.2
POST AVTransport/control HTTP/1.1
User-Agent: dlnap.py/0.15
Accept: */*
Content-Type: text/xml; charset="utf-8"
HOST: 192.168.1.2:60099
Content-Length: 558
SOAPACTION: "urn:schemas-upnp-org:service:AVTransport:1#SetAVTransportURI"
Connection: close

<?xml version="1.0" encoding="utf-8"?>
         <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <s:Body>
               <u:SetAVTransportURI xmlns:u="urn:schemas-upnp-org:service:AVTransport:1">
                  <InstanceID>0</InstanceID><CurrentURIMetaData></CurrentURIMetaData><CurrentURI>http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4</CurrentURI>
               </u:SetAVTransportURI>
            </s:Body>
         </s:Envelope>
POST AVTransport/control HTTP/1.1
User-Agent: dlnap.py/0.15
Accept: */*
Content-Type: text/xml; charset="utf-8"
HOST: 192.168.1.2:60099
Content-Length: 401
SOAPACTION: "urn:schemas-upnp-org:service:AVTransport:1#Play"
Connection: close

<?xml version="1.0" encoding="utf-8"?>
         <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <s:Body>
               <u:Play xmlns:u="urn:schemas-upnp-org:service:AVTransport:1">
                  <InstanceID>0</InstanceID><Speed>1</Speed>
               </u:Play>
            </s:Body>
         </s:Envelope>

可惜的，在測試播放影片時總不太順利，推論應當是兩個指令太快，改用 curl 指令測試就很正常：

1. 先設定影片

$ cat SetAVTransportURI.record
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<s:Body>
<u:SetAVTransportURI xmlns:u="urn:schemas-upnp-org:service:AVTransport:1">
<InstanceID>0</InstanceID>
<CurrentURIMetaData></CurrentURIMetaData>
<CurrentURI>http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4</CurrentURI>
</u:SetAVTransportURI>
</s:Body>
</s:Envelope>

$ curl -v -X POST --data @SetAVTransportURI.record  -H 'SOAPACTION: "urn:schemas-upnp-org:service:AVTransport:1#SetAVTransportURI"' -H 'Content-Type: text/xml; charset="utf-8"' http://192.168.1.2:60099/AVTransport/control
Note: Unnecessary use of -X or --request, POST is already inferred.
*   Trying 192.168.1.2:60099...
* TCP_NODELAY set
* Connected to 192.168.1.2 (192.168.1.2) port 60099 (#0)
> POST /AVTransport/control HTTP/1.1
> Host: 192.168.1.2:60099
> User-Agent: curl/7.68.0
> Accept: */*
> SOAPACTION: "urn:schemas-upnp-org:service:AVTransport:1#SetAVTransportURI"
> Content-Type: text/xml; charset="utf-8"
> Content-Length: 476
>
* upload completely sent off: 476 out of 476 bytes
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< EXT:
< CONTENT-TYPE: text/xml; charset="utf-8"
< SERVER: POSIX, UPnP/1.0, Intel MicroStack/1.0.2777
< Content-Length: 336
<
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <u:SetAVTransportURIResponse xmlns:u="urn:schemas-upnp-org:service:AVTransport:1">

      </u:SetAVTransportURIResponse>
   </s:Body>
* Connection #0 to host 192.168.1.2 left intact
</s:Envelope>

2. 呼叫播放

$ cat Play.record
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<s:Body>
<u:Play xmlns:u="urn:schemas-upnp-org:service:AVTransport:1">
<InstanceID>0</InstanceID>
<Speed>1</Speed>
</u:Play>
</s:Body>
</s:Envelope>

$ curl -v -X POST --data @Play.record  -H 'SOAPACTION: "urn:schemas-upnp-org:service:AVTransport:1#Play"' -H 'Content-Type: text/xml; charset="utf-8"' http://192.168.1.2:60099/AVTransport/control
Note: Unnecessary use of -X or --request, POST is already inferred.
*   Trying 192.168.1.2:60099...
* TCP_NODELAY set
* Connected to 192.168.1.2 (192.168.1.2) port 60099 (#0)
> POST /AVTransport/control HTTP/1.1
> Host: 192.168.1.2:60099
> User-Agent: curl/7.68.0
> Accept: */*
> SOAPACTION: "urn:schemas-upnp-org:service:AVTransport:1#Play"
> Content-Type: text/xml; charset="utf-8"
> Content-Length: 316
>
* upload completely sent off: 316 out of 316 bytes
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< EXT:
< CONTENT-TYPE: text/xml; charset="utf-8"
< SERVER: POSIX, UPnP/1.0, Intel MicroStack/1.0.2777
< Content-Length: 310
<
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <u:PlayResponse xmlns:u="urn:schemas-upnp-org:service:AVTransport:1">

      </u:PlayResponse>
   </s:Body>
* Connection #0 to host 192.168.1.2 left intact
</s:Envelope>

[macOS] 使用 cURL command 上傳檔案且修改 Content-Disposition filename 欄位資訊

故事是為了檢驗 embedded linux 上，一些 CGI 資安問題。例如有隻 CGI 提供檔案上傳時，通常上傳完後就把檔案擺在指定位置。但擺放到指定位置時，若沒有寫好，直接拿 filename 去擺放時，就有機會做邪惡的事了！

而透過 cURL 上傳檔案，通常是用以下簡單的指定就完成：

$ curl -F "file=@/tmp/sample.txt" http://192.168.1.1/cgi-bin/upload.cgi

但如果細看表單內容物時，產出的結果：

POST /cgi-bin/upload.cgi HTTP/1.1
Host: 192.168.1.1
Content-Type: multipart/form-data
Content-Length: ##

----------########
Content-Disposition: form-data; name="file";
filename="sample.txt"

...

這時，有些 CGI 開發上會直接拿上述 filename 參數資訊來用，寫不好就會產生跳脫問題，如：

Content-Disposition: form-data; name="file";
filename="../etc/sample.txt"

若底層是直接用 sprintf(des_filepath, "/tmp/%s", filename); 就會有機會逃脫去覆蓋掉東西。幸運的是 embedded linux 大多會設定檔案系統是 Read-only file system 來保護 :P 若是用 PHP 時，大多都靠 basename 來保護了。

最後，補上靠 curl 串改 filename 的招數：

$ curl -F "file=@/tmp/sample.txt; filename=../etc/sample.txt" http://192.168.1.1/cgi-bin/upload.cgi

透過 jq, sed, grep 從 wikipedia api 取出台灣地區鄉鎮市區列表 @ Ubuntu 14.04

靈光一想，想到撈一下台灣各地區，看到了這個：wiki 中華民國臺灣地區鄉鎮市區列表

http://zh.wikipedia.org/wiki/%E4%B8%AD%E8%8F%AF%E6%B0%91%E5%9C%8B%E8%87%BA%E7%81%A3%E5%9C%B0%E5%8D%80%E9%84%89%E9%8E%AE%E5%B8%82%E5%8D%80%E5%88%97%E8%A1%A8

接著想抓個鄉鎮對應表，就想起 wiki api：

http://zh.wikipedia.org/w/api.php?action=query&titles=%E4%B8%AD%E8%8F%AF%E6%B0%91%E5%9C%8B%E8%87%BA%E7%81%A3%E5%9C%B0%E5%8D%80%E9%84%89%E9%8E%AE%E5%B8%82%E5%8D%80%E5%88%97%E8%A1%A8&prop=revisions&rvprop=content&format=json

接著，再搭配 jq、sed、grep 縮一下資料量：

$ curl 'http://zh.wikipedia.org/w/api.php?action=query&titles=%E4%B8%AD%E8%8F%AF%E6%B0%91%E5%9C%8B%E8%87%BA%E7%81%A3%E5%9C%B0%E5%8D%80%E9%84%89%E9%8E%AE%E5%B8%82%E5%8D%80%E5%88%97%E8%A1%A8&prop=revisions&rvprop=content&format=json' | jq  '.query.pages[].revisions[0]|to_entries[0].value' | sed 's/\\n/\n/g' | grep -P '<small>(.*)</small> \[\[(.*)\]\]' -o | sed 's/<small>\(.*\)<\/small> \[\[\(.*\)\]\]/\1\t\2/g' | sed 's/\(.*\)\t\(.*\)|\(.*\)/\1\t\3/g'

成果：

基隆市 仁愛區

基隆市 中正區

基隆市 信義區

基隆市 中山區

基隆市 安樂區

基隆市 暖暖區

基隆市 七堵區

臺北市 中正區

臺北市 大同區

臺北市 中山區

臺北市 松山區

臺北市 大安區

臺北市 萬華區

臺北市 信義區

臺北市 士林區

臺北市 北投區

臺北市 內湖區

臺北市 南港區

臺北市 文山區

新北市 板橋區

新北市 新莊區

新北市 中和區

新北市 永和區

新北市 土城區

新北市 樹林區

新北市 三峽區

新北市 鶯歌區

新北市 三重區

新北市 蘆洲區

新北市 五股區

新北市 泰山區

新北市 林口區

新北市 淡水區

新北市 金山區

新北市 八里區

新北市 萬里區

新北市 石門區

新北市 三芝區

新北市 瑞芳區

新北市 汐止區

新北市 平溪區

新北市 貢寮區

新北市 雙溪區

新北市 深坑區

新北市 石碇區

新北市 新店區

新北市 坪林區

新北市 烏來區

桃園市 桃園區

桃園市 中壢區

桃園市 平鎮區

桃園市 八德區

桃園市 楊梅區

桃園市 蘆竹區

桃園市 大溪區

桃園市 龍潭區

桃園市 龜山區

桃園市 大園區

桃園市 觀音區

桃園市 新屋區

桃園市 復興區

新竹市 東區

新竹市 北區

新竹市 香山區

新竹縣 竹北市

新竹縣 竹東鎮

新竹縣 新埔鎮

新竹縣 關西鎮

新竹縣 湖口鄉

新竹縣 新豐鄉

新竹縣 峨眉鄉

新竹縣 寶山鄉

新竹縣 北埔鄉

新竹縣 芎林鄉

新竹縣 橫山鄉

新竹縣 尖石鄉

新竹縣 五峰鄉

宜蘭縣 宜蘭市

宜蘭縣 頭城鎮

宜蘭縣 礁溪鄉

宜蘭縣 壯圍鄉

宜蘭縣 員山鄉

宜蘭縣 羅東鎮

宜蘭縣 蘇澳鎮

宜蘭縣 五結鄉

宜蘭縣 三星鄉

宜蘭縣 冬山鄉

宜蘭縣 大同鄉

宜蘭縣 南澳鄉

苗栗縣 苗栗市

苗栗縣 造橋鄉

苗栗縣 西湖鄉

苗栗縣 頭屋鄉

苗栗縣 公館鄉

苗栗縣 銅鑼鄉

苗栗縣 三義鄉

苗栗縣 大湖鄉

苗栗縣 獅潭鄉

苗栗縣 卓蘭鎮

苗栗縣 竹南鎮

苗栗縣 頭份鎮

苗栗縣 三灣鄉

苗栗縣 南庄鄉

苗栗縣 後龍鎮

苗栗縣 通霄鎮

苗栗縣 苑裡鎮

苗栗縣 泰安鄉

臺中市 中區

臺中市 東區

臺中市 南區

臺中市 西區

臺中市 北區

臺中市 北屯區

臺中市 西屯區

臺中市 南屯區

臺中市 太平區

臺中市 大里區

臺中市 霧峰區

臺中市 烏日區

臺中市 豐原區

臺中市 后里區

臺中市 石岡區

臺中市 東勢區

臺中市 和平區

臺中市 新社區

臺中市 潭子區

臺中市 大雅區

臺中市 神岡區

臺中市 大肚區

臺中市 沙鹿區

臺中市 龍井區

臺中市 梧棲區

臺中市 清水區

臺中市 大甲區

臺中市 外埔區

臺中市 大安區

彰化縣 彰化市

彰化縣 員林鎮

彰化縣 和美鎮

彰化縣 鹿港鎮

彰化縣 溪湖鎮

彰化縣 二林鎮

彰化縣 田中鎮

彰化縣 北斗鎮

彰化縣 花壇鄉

彰化縣 芬園鄉

彰化縣 大村鄉

彰化縣 永靖鄉

彰化縣 伸港鄉

彰化縣 線西鄉

彰化縣 福興鄉

彰化縣 秀水鄉

彰化縣 埔心鄉

彰化縣 埔鹽鄉

彰化縣 大城鄉

彰化縣 芳苑鄉

彰化縣 竹塘鄉

彰化縣 社頭鄉

彰化縣 二水鄉

彰化縣 田尾鄉

彰化縣 埤頭鄉

彰化縣 溪州鄉

南投縣 南投市

南投縣 埔里鎮

南投縣 草屯鎮

南投縣 竹山鎮

南投縣 集集鎮

南投縣 名間鄉

南投縣 鹿谷鄉

南投縣 中寮鄉

南投縣 魚池鄉

南投縣 國姓鄉

南投縣 水-{里}-鄉

南投縣 信義鄉

南投縣 仁愛鄉

雲林縣 斗六市

雲林縣 斗南鎮

雲林縣 林內鄉

雲林縣 古坑鄉

雲林縣 大埤鄉

雲林縣 莿桐鄉

雲林縣 虎尾鎮

雲林縣 西螺鎮

雲林縣 土庫鎮

雲林縣 褒忠鄉

雲林縣 二崙鄉

雲林縣 崙背鄉

雲林縣 麥寮鄉

雲林縣 臺西鄉

雲林縣 東勢鄉

雲林縣 北港鎮

雲林縣 元長鄉

雲林縣 四湖鄉

雲林縣 口湖鄉

雲林縣 水林鄉

嘉義市 東區

嘉義市 西區

嘉義縣 太保市

嘉義縣 朴子市

嘉義縣 布袋鎮

嘉義縣 大林鎮

嘉義縣 民雄鄉

嘉義縣 溪口鄉

嘉義縣 新港鄉

嘉義縣 六腳鄉

嘉義縣 東石鄉

嘉義縣 義竹鄉

嘉義縣 鹿草鄉

嘉義縣 水上鄉

嘉義縣 中埔鄉

嘉義縣 竹崎鄉

嘉義縣 梅山鄉

嘉義縣 番路鄉

嘉義縣 大埔鄉

嘉義縣 阿里山鄉

臺南市 中西區

臺南市 東區

臺南市 南區

臺南市 北區

臺南市 安平區

臺南市 安南區

臺南市 永康區

臺南市 歸仁區

臺南市 新化區

臺南市 左鎮區

臺南市 玉井區

臺南市 楠西區

臺南市 南化區

臺南市 仁德區

臺南市 關廟區

臺南市 龍崎區

臺南市 官田區

臺南市 麻豆區

臺南市 佳里區

臺南市 西港區

臺南市 七股區

臺南市 將軍區

臺南市 學甲區

臺南市 北門區

臺南市 新營區

臺南市 後壁區

臺南市 白河區

臺南市 東山區

臺南市 六甲區

臺南市 下營區

臺南市 柳營區

臺南市 鹽水區

臺南市 善化區

臺南市 大內區

臺南市 山上區

臺南市 新市區

臺南市 安定區

高雄市 楠梓區

高雄市 左營區

高雄市 鼓山區

高雄市 三民區

高雄市 鹽埕區

高雄市 前金區

高雄市 新興區

高雄市 苓雅區

高雄市 前鎮區

高雄市 旗津區

高雄市 小港區

高雄市 鳳山區

高雄市 大寮區

高雄市 鳥松區

高雄市 林園區

高雄市 仁武區

高雄市 大樹區

高雄市 大社區

高雄市 岡山區

高雄市 路竹區

高雄市 橋頭區

高雄市 梓官區

高雄市 彌陀區

高雄市 永安區

高雄市 燕巢區

高雄市 田寮區

高雄市 阿蓮區

高雄市 茄萣區

高雄市 湖內區

高雄市 旗山區

高雄市 美濃區

高雄市 內門區

高雄市 杉林區

高雄市 甲仙區

高雄市 六龜區

高雄市 茂林區

高雄市 桃源區

高雄市 那瑪夏區

屏東縣 屏東市

屏東縣 潮州鎮

屏東縣 東港鎮

屏東縣 恆春鎮

屏東縣 萬丹鄉

屏東縣 崁頂鄉

屏東縣 新園鄉

屏東縣 林邊鄉

屏東縣 南州鄉

屏東縣 琉球鄉

屏東縣 枋寮鄉

屏東縣 枋山鄉

屏東縣 車城鄉

屏東縣 滿州鄉

屏東縣 高樹鄉

屏東縣 九如鄉

屏東縣 鹽埔鄉

屏東縣 里港鄉

屏東縣 內埔鄉

屏東縣 竹田鄉

屏東縣 長治鄉

屏東縣 麟洛鄉

屏東縣 萬巒鄉

屏東縣 新埤鄉

屏東縣 佳冬鄉

屏東縣 霧台鄉

屏東縣 泰武鄉

屏東縣 瑪家鄉

屏東縣 來義鄉

屏東縣 春日鄉

屏東縣 獅子鄉

屏東縣 牡丹鄉

屏東縣 三地門鄉

澎湖縣 馬公市

澎湖縣 湖西鄉

澎湖縣 白沙鄉

澎湖縣 西嶼鄉

澎湖縣 望安鄉

澎湖縣 七美鄉

花蓮縣 花蓮市

花蓮縣 鳳林鎮

花蓮縣 玉里鎮

花蓮縣 新城鄉

花蓮縣 吉安鄉

花蓮縣 壽豐鄉

花蓮縣 光復鄉

花蓮縣 豐濱鄉

花蓮縣 瑞穗鄉

花蓮縣 富里鄉

花蓮縣 秀林鄉

花蓮縣 萬榮鄉

花蓮縣 卓溪鄉

臺東縣 臺東市

臺東縣 成功鎮

臺東縣 關山鎮

臺東縣 長濱鄉

臺東縣 池上鄉

臺東縣 東河鄉

臺東縣 鹿野鄉

臺東縣 卑南鄉

臺東縣 大武鄉

臺東縣 綠島鄉

臺東縣 太麻里鄉

臺東縣 海端鄉

臺東縣 延平鄉

臺東縣 金峰鄉

臺東縣 達仁鄉

臺東縣 蘭嶼鄉

金門縣 金城鎮

金門縣 金湖鎮

金門縣 金沙鎮

金門縣 金寧鄉

金門縣 烈嶼鄉

金門縣 烏坵鄉

連江縣 南竿鄉

連江縣 北竿鄉

連江縣 莒光鄉

連江縣 東引鄉

[PHP] 使用 CodeIgniter 和 codeigniter-restserver 建立 RESTful API 以及測試方式 @ Ubuntu 14.04

環境資訊：

• Ubuntu 14.04 64 Bit (lsb_release -a)
• PHP 5.5.9 (php -v)
• CodeIgniter 2.2.0 (echo CI_VERSION)

接著，透過 github.com/chriskacerguis/codeigniter-restserver 擴充 CodeIgniter：

$ wget https://raw.githubusercontent.com/chriskacerguis/codeigniter-restserver/master/application/config/rest.php -O /path/ci_proj/application/config/rest.php

$ wget https://raw.githubusercontent.com/chriskacerguis/codeigniter-restserver/master/application/libraries/Format.php -O /path/ci_proj/application/libraries/Format.php

$ wget https://raw.githubusercontent.com/chriskacerguis/codeigniter-restserver/master/application/libraries/REST_Controller.php -O /path/ci_proj/application/libraries/REST_Controller.php

接著，請確認 application/config/rest.php 設定：

$config[rest_default_format] = 'json'; // 預設為 xml

之後，就可以撰寫簡單的 RESTful API 啦：

<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
require(APPPATH.'/libraries/REST_Controller.php');

class Item extends REST_Controller {
        public function index_get() {
                $this->list_get();
        }
        public function index_post() {
                $this->add_post();
        }
        public function index_put() {
                $this->update_put();
        }
        public function index_delete() {
                $this->delete_delte();
        }

        public function list_get() {
                echo "list";
        }
        public function add_post() {
                echo "create";
        }
        public function update_put() {
                echo "put";
        }
        public function remove_delete() {
                echo "remove";
        }
}

測試方式：

取得清單(GET)

$ curl -X GET http://localhost/ci_proj/item/list
$ curl -X GET http://localhost/ci_proj/item/

新增資料(POST)

$ curl -X POST http://localhost/ci_proj/item/add
$ curl -X POST http://localhost/ci_proj/item/

更新資料(PUT)

$ curl -X PUT http://localhost/ci_proj/item/update
$ curl -X PUT http://localhost/ci_proj/item/

刪除資料(DELETE)

$ curl -X DELETE http://localhost/ci_proj/item/delete
$ curl -X DELETE http://localhost/ci_proj/item/

也可以用 wget --method GET/POST/PUT/DELETE 等進行測試。

至於 RESTful 常見的 HTTP STATUS CODE，可以參考 Using HTTP Methods for RESTful Services

例如:

取得清單成功回應 200 OK，失敗則為 404 NOT FOUND；新增資料成功 200 OK 或是 201 LOCATION 到新增項目的 URI，失敗為 404 NOT FOUND；更新資料成功為 200 OK，失敗為 404 NOT FOUND；刪除資料成功為 200 OK，失敗為 404 NOT FOUND。

接著，是設計每個 GET, POST, PUT, DELETE API 細節，可以分別使用 $this->get('param')、$this->post('param')、$this->put('param') 和 $this->delete('param') 取得對應資料，而回應時，需要的 HTTP Status Code 可以使用：

$this->response( array('status' => true), 200);
$this->response( array('status' => false, 'error' => 'error message'), 400);
$this->response( array('status' => false, 'error' => 'error message'), 404);

若要 debug 的話，大概可以用：

$this->response( array('status' => true, 'get' => $this->get(), 'post' => $this->post(), 'put' => $this->put(), 'delete' => $this->delete() ), 200);

搭配 curl -i -X GET|POST|PUT|DELETE -d 'key=value' 方式進行，除了可以看到 HTTP Response code 外，也能看到 get, post, put, delete 各種參數資訊：

$ curl -i -X DELETE -d "haha=hehe" CGI
HTTP/1.1 200 OK
Server: Apache/2.4.7 (Ubuntu)
X-Powered-By: PHP/5.5.9-1ubuntu4.5
Content-Length: 68
Content-Type: application/json; charset=utf-8

{"status":true,"get":[],"post":[],"put":[],"delete":{"haha":"hehe"}}

[PHP] 使用 CURL 測試 Remote Resource Availability @ Ubuntu 14.04

有些程式跑在對岸，就該測測網路是否可取得啦

<?php
function checkRemoteResourceAvailability($target_url) {
        $ch = curl_init($target_url);
        curl_setopt($ch, CURLOPT_NOBODY, true);
        $status = curl_exec($ch) !== false && curl_getinfo($ch, CURLINFO_HTTP_CODE) == 200;
        curl_close($ch);
        return $status;
}

echo checkRemoteResourceAvailability('http://tw.yahoo.com/favicon.ico') ? "ok" : "not available";