Command Line Switches and Other New Features

[LeeThompson]

Overview

By it's design, it appears that the original use case had this run as a web script whereas I am using it as a command line tool so it should be tested for the various environments/use cases.

Changes

• [x] Functions grap_favicon and load now have an additional parameter, $consolemode (default is false).
• [x] Function load can also take a fourth parameter, $timeOut (default is 60)
• [x] grap_favicon array now has an additional parameter, OVR for overwriting files. Default is false.
• [x] Command Line switches are implemented. Any parameter with a space in it needs to be quoted.

Command Line Switches:

• [x] --list (or -l) can be a text file with a list or URLs or a , ; or space delimited list. (e.g. --list=http://www.google.com,http://www.microsoft.com --list=myfile.txt)
• [x] --path (or -p), local save path (e.g. --path="D:\My Icons\")
• [x] --store; store local files (alias --save) (default)
• [x] --nostore; do not store local files (alias --nosave)
• [x] --tryhomepage; try homepage first (default)
• [x] --onlyuseapis; only use apis
• [x] --consolemode; output regular text
• [x] --noconsolemode; output html (default; subject to detection)
• [x] --overwrite (overwrite local file if present)
• [x] --skip (skip local file if present; default)
• [x] --curl-verbose (show curl verbose messages)
• [x] --curl-timeout (set curl timeout, default is 60) (e.g --curl-timeout=30)
• [x] --user-agent (specify a specific user agent) (e.g. --user-agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36")
• [x] --debug; enable debug mode
• [x] --help (or -? or -h)

Other Features:

• [x] Detects image format and saves the local file accordingly
• [x] Detects console or HTTP/CGI mode
• [x] "Console Mode" shows regular text instead of HTML

Other Items:

• [x] Checks if local save path exists (if set other than default)
• [x] cURL timeout can be set but defaults to 60
• [x] "Console Mode" skips set_time_limit
• [x] "Console Mode" shows a runtime total

Usage Examples

C:\php\php.exe get-fav.php --list=sites.txt --path=icons --save --debug C:\php\php.exe get-fav.php --list=http://www.microsoft.com,http://www.google.com --path=icons --save

Notes

I've been testing pretty heavily, I've made some changes but nothing major, adding some more debug entries (mostly for me lol).

There is an issue where sometimes it takes a really long time for a download to fail but I think it's beyond the script and sometimes CURL is not honoring timeouts.

[LeeThompson]

I am working on some more features.

Stuff being worked on:

• [ ] More command line switches for troubleshooting and for specific situations allowing control over connection, http and dns timeouts.
• [ ] Allow manual disabling of curl.
• [ ] Icon validation where it can be checked with generic fallback icons (via md5 hash comparisons in a 'blocklist')
• [ ] Ability to enable/disable each of the 3 API methods
• [ ] Configuration file support (command line switches will still override the config)
• [ ] Improved error handling
• [ ] Option to strip the TLD domain from the filename (.e.g microsoft.com.ico becomes microsoft.ico)

[gaffling]

I am so sorry - you are a very nice guy and I appreciate your work - my inbox is so full of unfinished work that I forgot to include your request :-( will do better in the future - thanks for your patience

[LeeThompson]

No worries!