161
modifications
Modifications
aucun résumé de modification
{{caution |notes= If this mod is installed or configured incorrectly it could make your site appear to crash. Don't panic. Edit your subroot.php and remove the last line pertaining to Prolog. Then in mod manager "Clean" the partially installed Prolog to remove the mod.''' [[#Warning|See Below for detail]]
{{caution |notes= If this mod is installed or configured incorrectly it could make your site appear to crash. Don't panic. Edit your subroot.php and remove the last line pertaining to Prolog. Then in mod manager "Clean" the partially installed Prolog to remove the mod.''' [[#Warning|See Below for detail]]
}}
}}{{restricted}}
{{restricted}}
{{TNGmod
{{TNGmod
| mod_name = Prolog Mod
| mod_name = {{PAGENAME}}
| mod_summary = Adds PHP Rotating Logs to TNG site
| mod_summary = Adds PHP Rotating Logs to TNG site
| mod_validation =
| mod_validation =
| mod_last_update = 4 Jul 2021
| mod_last_update = 11 Mar 2024
| download_link =
| download_link = <div style="display:inline-block;width:95%;">[https://bisbeefamily.com/ccount/click.php?id=264&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} version 14.0.0.20.zip]<div style="float:right;">{{Tv140|float=left}}</div></div>
<div style="display:inline-block;width:95%;">[https://bisbeefamily.com/ccount/click.php?id=187&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} version 12.0.0.9.zip]<div style="float:right;">{{Tv120|float=left}}</div></div>
<div style="display:inline-block;width:95%;">[https://bisbeefamily.com/ccount/click.php?id=220&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} version 13.0.0.11.zip]<div style="float:right;">{{Tv130|float=left}}</div></div>
<!-- https://tng.lythgoes.net/wiki/images/a/a3/Prolog_v12.0.0.9.zip -->
| download_stats = [https://bisbeefamily.com/ccount/index.php?action=stats&groupid=22 view statistics]
<div style="display:inline-block;width:95%;">[https://bisbeefamily.com/ccount/click.php?id=221&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} version 12.0.0.11.zip]<div style="float:right;">{{Tv120|float=left}}</div></div>
| download_stats = [https://bisbeefamily.com/ccount/index.php?action=stats&groupid=18 view statistics]
| mod_author = [[User:Kazooter|Rick Bisbee]]
| mod_author = [[User:Kazooter|Rick Bisbee]]
| mod_url = [https://bisbeefamily.com/ Bisbee Family Connection]
| mod_url = [https://bisbeefamily.com/ Bisbee Family Connection]
| mod_support = [https://bisbeefamily.com/support.php?mod={{PAGENAMEE}} Support for {{PAGENAMEE}}]
| mod_support = [https://bisbeefamily.com/support.php?mod={{PAGENAMEE}} Support for {{PAGENAMEE}}]
| mod_contact = As above
| mod_contact = As above
| mod_version = 13.0.0.11
| mod_version = 14.0.0.20
| use_mod_manager = Yes
| use_mod_manager = Yes
| manual_install = No
| manual_install = No
| min_TNG_ver = 12.0
| min_TNG_ver = 13.0
| max_TNG_ver = 13.0+
| max_TNG_ver = 14.0+
| TNG_file_list =
| TNG_file_list =
| related_mods =
| related_mods =
| notes =
| notes =
}}
}}{| style="margin-right:0.5 em;" align="right"
{| style="margin-right:0.5 em;" align="left"
| __TOC__
| __TOC__
|}
|}
== Prolog (PHP Rotating Log) Introduction ==
== Prolog (PHP Rotating Log) Introduction ==
[[Image:Prolog6.png|left|150px]]
[[Image:Prolog6.png|left|150px]]
Prolog is a utility for TNG testers, mod developers and anyone who wants to monitor their websites for PHP or user issues. It is an extension of the Show PHP Errors mod created by Roger Mitchell (decd) and provides three selectable levels of error logging: 1) just errors; 2) all errors, warnings and deprecations except for notices (default); or 3) all errors, warnings, notices, and deprecated functions.
Prolog is a utility for TNG testers, mod developers and anyone who wants to monitor their websites for PHP or user issues. It is an extension of the Show PHP Errors mod created by Roger Mitchell (decd) and provides nine selectable levels of error logging from Errors only to all errors, warnings, notices and deprecations.
''An important feature is that fatal errors displayed to the screen are generic and never reveal server information that a hacker may be looking for. The actual error can be found in the error log using the same timestamp shown on the screen.''
''An important feature is that fatal errors displayed to the screen are generic and never reveal server information that a hacker may be looking for.''
===<span style='color:#990000'>Important Note for TNGv14 Users</span>===
<p style='font-style:italic'>Prolog was updated for TNGv14. In Previous versions, Prolog was initialized in subroot.php. Starting with TNGv14, Prolog v14 is initialized in begin.php. This change makes it very important that you completely uninstall any previous versions you may have tried in TNGv14, before installing Prolog v14. '''Neglecting to do this may leave unwanted code in TNG files that will result in TNG errors and even site failure.'''</p>
<p>Prolog v14 will fail with errors if any components of previous versions have not been uninstalled.<p>
===Error Log Location===
===Error Log Location===
Prolog will use the php.ini error_log setting to place its logs in the same location as PHP. If the php.ini is not set, or if it is inaccessible, prolog will use the TNG root-relative path you've set in the Mod Edit Options. If not set there, Prolog will create and default to a logs directory in your TNG root directory. While the last option works fine for offline test sites, for security reasons it is not recommended for a live site.
Prolog will 1) use the php.ini error_log setting to place its logs in the same location as PHP. If the php.ini is not set, or if it is inaccessible, prolog will 2) use the TNG root-relative path you've set in the Mod Edit Options. If not set there, Prolog will 3) create and default to a logs directory in your TNG root directory. While the third option works fine for offline test sites, for security reasons it is not recommended for a live site.
====php.ini error_log directive====
====php.ini error_log directive====
! Date
! Date
! Updates
! Updates
|- valign="top"
| v14.0.0.20
| 12 Mar 2024
|
* Fixes clash between session filters in Mod Manager and Prolog.
|- valign="top"
|- valign="top"
| v13.0.0.11<br />v12.0.0.11
| v14.0.0.19
|26 Jul 2021
| 11 Mar 2024
|
|
* Changes case on support file name for servers that are case sensitive
* User-selected log files and filters are now persistent during the same session. If you navigate away from the page and later return, the same log file and filter selections will apply. You must manually re-select another log file and clear the filter to change them.
|- valign="top"
|- valign="top"
| v13.0.0.10<br />v12.0.0.10
| v14.0.0.18
|4 Jul 2021
| 31 Jan 2023
|
|
* Fixes broken Prolog error file view when backtraces contain special html entities.
* Expands choices for error reporting level
|- valign="top"
| v14.0.0.17
| 28 Jan 2023
|
* Fixes warnings after log file is cleared
|- valign="top"
| v14.0.0.16
| 1 Jan 2023
|
* Fixes warnings
* Minor syntactic updates
|- valign="top"
| v14.0.0.15
| 17 Dec 2022
|
* Fixes filemtime problem in Windows
|- valign="top"
| v14.0.0.14
| 14 Dec 2022
|
* Not released
|- valign="top"
| v14.0.0.13
| 10 Sep 2022
|
* Updated to work with TNGv14
* Inserts Prolog.conf.php into begin.php vice subroot.php to prevent conflict with the GEDCOM upload progress bar
* Checks for correct version of TNG before allowing installation
* Checks for uninstalled components of previous version of Prolog
* New mod editor option to set the timezone for the log entries
* Updated mod option to display errors to the screen: set to 0, only the public message displays; set to 1, only the raw PHP error is displayed (for developers)
* Moves prolog_conf.php file to the extensions directory
|- valign="top"
|- valign="top"
The error log file should use the extensions '''.log'''.
The error log file should use the extensions '''.log'''.
=== Setting the Error Level ===
=== Setting the Error Level for Logging ===
Error Level settings are designated by adding the index numbers for the items you want reported.
0 == ERRORS<br />
1 == WARNINGS<br />
2 == NOTICES<br />
4 == DEPRECATED<br />
9 == ALL
E_ERROR is always reported. Errors alone are index 0.
* Error level 3 logs everything -- errors, notices, warnings and deprecations. Because TNG emotes large numbers of notices right now, error level 3 should only be used while actually testing a script and reduced back to 1 or 2 when not testing. Even a daily log can get very large at error level 3.
To specify E_ERROR and an additional type, enter the additional type index number into the parameter box. To specify a combination of error reporting, just add the index numbers and enter the total for the parameter.
A complete map:<br />
0 == errors<br />
1 == errors and warnings (1)<br />
2 == errors and notices (2)<br />
3 == errors and warnings and notices (1+2)<br />
4 == errors and deprecated (4)<br />
5 == errors and warnings and deprecated (1+4)<br />
6 == errors and notices and deprecate (2+4)<br />
7 == errors and warnings and notices and deprecated (1+2+4)<br />
9 == E_ALL
* Error level 5 should be about right for a live site. It will log errors, warnings and PHP function deprecations. That latter means the scripts will stop working with new PHP upgrades, so we should know about them. Error level 1 would just be errors and warnings.
* Error level 9 logs everything -- errors, notices, warnings, deprecations and everything else. Because TNG emotes large numbers of notices right now, error level 3 should only be used while actually testing a script and reduced back to 1 or 5 when not testing. Even a daily log can get very large at error level 9.
== Warning ==
== Warning ==
== Sites using this mod ==
== Sites using this mod ==
If you download this mod, please add your TNG site to the table below:
If you download and install this mod, please add your TNG site to the table below:
{| class="wikitable" border="0" cellspacing="1" cellpadding="2"
{| border="0" cellspacing="1" cellpadding="2" class="wikitable" width="100%"
|-
|-
! URL
! URL
! TNG-Version
! TNG-Version
! User-language
! User-language
|-
|- style="vertical-align:top;"
| [http://www.bisbeefamily.com A Bisbee Family History]
| style="white-space: nowrap;"|[[User:kazooter|Rick Bisbee]]
| Mod Developer. A must-have for mod developers
| 12.0.0.7
| 12.1
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
|[https://tng.stegemueller.dk Stegemüller Family History]
|[https://tng.stegemueller.dk Stegemüller Family History]
|[https://tng.lythgoes.net/wiki/index.php/User:Stegemüller Hanne B. Stegemüller]
| style="white-space: nowrap;"|[[User:Stegemüller|Hanne B. Stegemüller]]
|Public site
|Public site
|13.0.0.11
|14.0.0.16
|13.1.2
|14.0
|EN, DE, DA
| style="white-space: nowrap;"|EN,DE,DA
|- style="vertical-align:top;"
| Mod Developer. A must-have for mod developers
| [https://www.royandboucher.com/ Our Roy and Boucher Family]
| [https://www.royandboucher.com/ Our Roy and Boucher Family]
| [[User:KenRoy|Ken Roy]]
| style="white-space: nowrap;"|[[User:KenRoy|Ken Roy]]
| Using with [[Show PHP Error Log]] on test site
| Using with [[Show PHP Error Log]] on test site
| 13.0.0.11
| 14.0.0.18
| 13.1.1
| {{Tv1404|float=left}}
| EN, FR
| style="white-space: nowrap;"|EN,FR
|-
|- style="vertical-align:top;"
| [https://www.kmtrees.com/index.php Roots & Relatives Remembered]
| [https://www.kmtrees.com/index.php Roots & Relatives Remembered]
| [[User:tngrlkrz| Ron Krzmarzick]]
| style="white-space: nowrap;"|[[User:tngrlkrz|Ron Krzmarzick]]
| Public & Private
| Public & Private
| [https://www.kmtrees.com/rrmodcompare_report.php?power=basic&cachemethod=3&sb=filename&aformat=full&statushilite=1&b1=0 See Here]
| [https://www.kmtrees.com/mods-installed See Here]
| [https://www.kmtrees.com/rrmodcompare_report.php?power=basic&cachemethod=3&sb=filename&aformat=full&statushilite=1&b1=0 See Here]
| [https://www.kmtrees.com/mods-installed See Here]
| EN,DE,CS
| EN,DE,CS
|-
|- style="vertical-align:top;"
| [https://www.gilbert-family-history.net Gilbert Family History]
| [https://www.gilbert-family-history.net Gilbert Family History]
| [[User:WarrenGilbert| Warren Gilbert]]
| style="white-space: nowrap;"|[[User:WarrenGilbert|Warren Gilbert]]
| Public
| Public
| 13.0.0.9
| 14.0.0.15
| 13.0
| 14.0
| English
| style="white-space: nowrap;"|EN
|
|-
|- style="vertical-align:top;"
| [http://genealogie.mkirsch.be Racines luxo-hennuyeres]
| style="white-space: nowrap;"|[http://genealogie.mkirsch.be Racines luxo-hennuyeres]
| [[User:MichelKirsch|Michel Kirsch]]
| [[User:MichelKirsch|Michel Kirsch]]
|
| Registration
| 13.0.0.11
| 14.0.0.20
| 13.1
| 14.0.4
| FR/EN/NL/D/SP}
| style="white-space: nowrap;"|FR,EN,NL,DE,SP
|-
|- style="vertical-align:top;"
| [http://genealogy.oceanwharf.com Hooley Family Links]
| [http://genealogy.oceanwharf.com Hooley Family Links]
| [[User: lastejas|Rick Hooley]]
| style="white-space: nowrap;"|[[User:lastejas|Rick Hooley]]
| Public/Private, only used on test server
| Public/Private, only used on test server
| [[User: lastejas|See Here]]
| [[User: lastejas|See Here]]
| [[User: lastejas|See Here]]
| [[User: lastejas|See Here]]
| EN
| style="white-space: nowrap;"|EN
|-
|- style="vertical-align:top;"
| [https://www.rgstrong-genes.com R G Strong Family Genealogy]
| [https://www.rgstrong-genes.com R G Strong Family Genealogy]
| [[User:Rgstrong|Russell Strong]]
| style="white-space: nowrap;"|[[User:Rgstrong|Russell Strong]]
| Public/Private
| Public/Private
| 13.0.0.11
| 14.0.0.18
| 13.1.1
| 14.0.4
| EN/DE/FR/NL
| style="white-space: nowrap;"|EN,DE,FR,NL
|-
|- style="vertical-align:top;"
| [https://www.josephoranholtz.com/ Joseph Oran Holtz Genealogy Pages]
| [https://www.josephoranholtz.com/ Joseph Oran Holtz Genealogy Pages]
| [[User:Stores|Jim Holt]]
| style="white-space: nowrap;"|[[User:Stores|Jim Holt]]
| Private
| Private
| [[User:Stores|See Here]]
| [[User:Stores|See Here]]
| [[User:Stores|See Here]]
| [[User:Stores|See Here]]
| EN
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
|[https://www.pittsburghoneils.com Pittsburgh O'Neils]
| style="white-space: nowrap;"|[[User:Spo9496|Sean O'Neil]]
|
|
| 13.1.2
| style="white-space: nowrap;"|EN
|- style="vertical-align:top;"
|[https://cnl-gla.ca/nos-ancetres/lapierreamerique/ Les Lapierre d'Amérique]
| style="white-space: nowrap;"|[[User:NLapierre|Normand Lapierre]]
| Public/Private site
| 14.0.0.16
| 14.0
| style="white-space: nowrap;"|FR,EN
|- style="vertical-align:top;"
| [https://www.severijns.family/Severijns The Severijns / Timmer Familytree]
| style="white-space: nowrap;"|[[User:Severijns|Rob Severijns]]
| Public / Private
| 14.0.0.18
| 14.0.4
| style="white-space: nowrap;"|NL,EN
|- style="vertical-align:top;"
| [https://zausmerforest.com Zausmer Forest]
| style="white-space: nowrap;"|[[User:Joyaa|Joyaa Antares]]
| Private
| 14.0.0.18
| 14.0.2
| style="white-space: nowrap;"|EN,FR
|- style="vertical-align:top;"
| [https://clan.chauvigne.info/ GénéaKat]
| style="white-space: nowrap;"|[[User:Katryne|Katryne]]
| Public & private
| 14.0.0.18
| 14.0.3
| style="white-space: nowrap;"|FR,EN
|- style="vertical-align:top;"
| [https://datschetzky.genealogenstammtisch.net Stammbaum der Familie Datschetzky]
| style="white-space: nowrap;"|[[User:ChristianD|Christian Datschetzky]]
| Public
| 14.0.0.18
| 14.0.3
| style="white-space: nowrap;"|DE,EN
|- style="vertical-align:top;"
| Development server
| style="white-space: nowrap;"|[[User:Brett|Brett]]
| Local host
| 12.0.9, 14.0.0.20
| 12 - 14
| style="white-space: nowrap;"|EN
|-
|-
|https://carverfamilytree.us
|[[User: Bob Carver|Bob Carver]]
|Public/Private
|14.0.0.20
|{{Tv1404|float=left}}
|EN
|}
[[Category:Mods for TNG v14]]
[[Category:Mods for TNG v13]]
[[Category:Mods for TNG v13]]
[[Category:Mods for TNG v12]]
[[Category:Mods for TNG v12]]
[[Category:Administrator]]
[[Category:Administrator]]
[[Category:Maintenance]]
[[Category:Maintenance]]
[[Category:Troubleshooting]]
[[Category:Troubleshooting]]