Debugging: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Hauptseite ► Moodle administrieren ► Entwicklerwerkzeuge ► Debugging
Entwicklerwerkzeuge
(Die Seite wurde neu angelegt: „{{Entwicklerwerkzeuge}} Als Administrator/in können Sie die Ausgabe von Debugging-Nachrichten auf der Seite ''Einstellungen > Website-Adm…“)
 
Keine Bearbeitungszusammenfassung
 
(5 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Entwicklerwerkzeuge}}
{{Entwicklerwerkzeuge}}
Als Administrator/in können Sie die Ausgabe von Debugging-Nachrichten auf der Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Entwicklung > Debugging'' aktivieren.
Als Administrator/in können Sie die Ausgabe von Debugging-Nachrichten auf der Seite ''Website-Administration'' (oder im Block ''[[Einstellungen-Block|Einstellungen]]) > Website-Administration'')'' > Entwicklung > Debugging'' aktivieren.
 
==Debugging-Nachrichten verwenden==


Debugging-Nachrichten helfen bei der Analyse von Problemen oder Fehlern und sind für Entwickler/innen nützlich. Wenn Sie ein Problem mit Ihrer Moodle-Site haben und in einem der Support-Foren von moodle.org Hilfe suchen, kann es passieren, dass Entwickler/innen Sie bitten, das Debugging zu aktivieren, um mehr Informationen zur Analyse Ihres Problems zu erhalten. Standardmäßig werden in Moodle keinerlei Fehlerinformationen ausgegeben. Das Aktivieren des Debugging-Modus ist meistens ein erster Schritt zur Fehleranalyse- und behebung.
Debugging-Nachrichten helfen bei der Analyse von Problemen oder Fehlern und sind für Entwickler/innen nützlich. Wenn Sie ein Problem mit Ihrer Moodle-Site haben und in einem der Support-Foren von moodle.org Hilfe suchen, kann es passieren, dass Entwickler/innen Sie bitten, das Debugging zu aktivieren, um mehr Informationen zur Analyse Ihres Problems zu erhalten. Standardmäßig werden in Moodle keinerlei Fehlerinformationen ausgegeben. Das Aktivieren des Debugging-Modus ist meistens ein erster Schritt zur Fehleranalyse- und behebung.


==Debugging-Einstellungen==
==Debugging-Einstellungen==
Für das Debugging können Sie folgende Einstellungen vornehmen:
Für das Debugging können Sie folgende Einstellungen vornehmen:


===Debug messages===
===Debug-Mitteilungen===
The default is none, your choices are:
Die Standardeinstellung ist ''KEINE: keine Fehlermeldungen oder Warnungen anzeigen''. Weitere Optionen sind:


;NONE : Do not show any errors or warnings (Default)
;ALLE: alle notwendigen PHP-Debug-Mitteilungen anzeigen
;ALL : Show all reasonable PHP debug messages
;MINIMAL: nur schwerwiegende Fehler anzeigen
;MINIMAL : Show only fatal errors
;NORMAL: Fehler, Warnungen und Bemerkungen anzeigen
;NORMAL : Show warnings, errors and notices
;DEVELOPER: besondere Moodle-Debug-Mitteilungen für Entwickler anzeigen
;DEVELOPER : extra Moodle debug messages for developers


There is rarely any advantage in going to Developer level, unless you are a developer, in which case it is strongly recommended.
Es gibt selten Sitautionen, wo Sie den DEVELOPER-Modus benötigen, solange Sie nicht selbst als Entwickler/in arbeiten. Entwickler/innen sollten dagegen unbedingt die DEVELOPER-Option verwenden.


Once you have got the error message, and copied and pasted it somewhere. HIGHLY RECOMMENDED to turn Debug back to NONE. Debug messages can give clues to a hacker as to the setup of your site.
Wenn Sie eine Fehlermeldung in Moodle erhalten, kopieren und speichern Sie diese an einer geeigneten Stelle. Es wird dringend empfohlen, danach den Modus wieder auf KEINE zurückzustellen, da die Fehlermeldungen sonst Angriffsflächen für Hacker bieten.


===Display debug messages===
===Debug-Mitteilungen anzeigen===


There is an option to choose whether to display error messages or simply record them in the server logs.
Wenn Sie diese Checkbox markieren, werden die Debug-Mitteilungen direkt im Browser angezeigt, andernfalls werden sie in den Server Logs gespeichert.


===Debug email sending===
===Debug-Mitteilungen zum E-Mail-Versand===
Wenn Sie diese Checkbox markieren, werden umfassende Debug-Mitteilungen beim E-Mail-Versand über den SMTP-Server erstellt.


Determines whether or not to enable verbose debug information during sending of email messages to SMTP server.
==== More tools for debugging outgoing mail (SMTP) ====
You can also use the config.php file to turn on more "tools" which will assist you with debugging the outgoing emails (and SMTP server configuration):
* Redirect all outgoing emails to a specific address:
<code php>
// Divert all outgoing emails to this address to test and debug emailing features
// $CFG->divertallemailsto = 'root@localhost.local'; // NOT FOR PRODUCTION SERVERS!
</code>


===Performance info===
* Turn on the CRON debugging and run CLI cron.php script.
<code php>
// Force developer level debug and add debug info to the output of cron
// $CFG->showcrondebugging = true;
</code>
And then use SSH (or putty.exe, on windows) to run:
<code php>
you@moodle-server(/var/www/html/moodle)# php admin/cli/cron.php
</code>


The Performance info option determines whether performance info will be included in the footer of the standard theme (and some other themes). Performance info includes the time for the page to load, the amount of memory used to generate the page, cpu usage, load, and the record cache hit/miss ration.
* Turn on verbose SMTP debugging and output it into system's error_log (code hack):
As [https://moodle.org/mod/forum/discuss.php?d=316222#p1289850 suggested] on Moodle's discussion forums:
Open [https://github.com/moodle/moodle/blob/master/lib/moodlelib.php#L5379 lib/moodlelib.php L5379] and change it to:
<code php>
if (!empty($CFG->debugsmtp)) {
    $mailer->SMTPDebug = 1;  // 0 - no debug ... 4 - low level full debug
    $mailer->Debugoutput = "error_log";
}
</code>
See more info about [https://github.com/moodle/moodle/blob/master/lib/phpmailer/class.phpmailer.php#L314 SMTPDebug] parameters & [https://github.com/moodle/moodle/blob/master/lib/phpmailer/class.phpmailer.php#L328 Debugoutput] parameters,
Set-up mailcatcher (https://mailcatcher.me/).


If you add
===Performance===
wenn Sie diese Checkbox markieren, dann wird beim Standard-Design (und einigen anderen Designs) in der Fußzeile eine Information über die Geschwindigkeit angezeigt. Zu diesen Informationen gehören die Ladezeit für eine Moodle-Seite, der benötigte Speicherbedarf, die CPU-Last und eine Cache-Information.
 
Wenn Sie folgenden Code in Ihre Moodle-Konfigurationsdatei ''config.php'' einfügen, dann werden außerdem die Datenbankabfragen gezählt:
<code php>
<code php>
define('MDL_PERF', true);
define('MDL_PERF', true);
Zeile 41: Zeile 68:
define('MDL_PERFTOFOOT', true);
define('MDL_PERFTOFOOT', true);
</code>
</code>
to your config.php file, then it will also count database queries. (This has to be in config.php, because Moodle starts doing DB queries before it loads the config information in the database!


===Show origin of language strings===
Dieser Code gehört in die Konfigurationsdatei, weil Moodle Datnabnkabfragen durchführt, bevor die Konfigurationsinformation in die datenbank geladen wird.
Helps translators.


===Show validator links===
===Herkunft der Texte anzeigen===
Be careful, read the warning.
Diese Einstellung ist für Übersetzer/innen nützlich. Sometimes <code>?strings=1</code> should be added; other times <code>&strings=1</code>. See the Wikipedia article [http://en.wikipedia.org/wiki/Query_string Query string] for details.


===Show page information===
===Prüflinks anzeigen===
To show page information printed in the page footer.
Wenn Sie diese Checkbox markieren, werden Links zu externen Validierungsservern in der Fußzeile angezeigt. Möglicherweise müssen Sie einen neuen Nutzer mit dem Anmeldenamen ''w3cvalidator'' erstellen und den Gastzugang freischalten. Wenn Sie diese Funktionalität aktivieren, sind unauthorisierte Serverzugriffe erlaubt, deshalb wird vom Einsatz auf Produktivsystemen dringend abgeraten.


==What to do if you cannot get to the admin screens==
===Seiteninformation anzeigen===
Wenn Sie diese Checkbox markieren, werden Seiteninformationen in der Fußzeile angezeigt.


If the error is stopping you even getting to the admin screens to turn on debugging, then you can set the debugging setting manually.
===SQL-Abfragen debuggen===
You can add (turn ON) any of the following dboptions in your config.php files, which log different types of SQL queries into mdl_log_queires table:
* '''logall''' - log all queries - suitable only for developers, causes high server loads and NOT recommended for production.
* '''logslow''' - log queries that take longer than specified number of seconds (float values are accepted).
* '''logerrors''' - log all error queries.


===Try typing the URL directly===
Full sample:
 
<code php>
The debug settings are at the URL <code><nowiki>http://.../admin/settings.php?section=debugging</nowiki></code> on your server. Sometimes that URL will work, even though the pages you need to go to to get there (for example the site front page) do not. So it is worth trying to enter that URL directly.
$CFG->dboptions = array (
 
  //'logall'  => true,
===In config.php===
  'logslow'  => 5,
  'logerrors'  => true,
);
</code>


In moodle/config.php you can add the lines:


<code php>
==Was mache ich, wenn ich keinen Zugriff auf die Debugging-Seite habe?==
$CFG->debug = 2047;
Wenn Sie eine Fehlermeldung erhalten und gar nicht mehr auf die Debugging-Seite gelangen, um den Debug-Modus zu aktivieren, dann können Sie das Debugging auch manuell einschalten:
$CFG->debugdisplay = 1;
</code>


Or even more debugging messages:
===Direkt über die URL===
Die Debugging-Seite erreichen Sie über die direkte URL <code><nowiki>http://.../admin/settings.php?section=debugging</nowiki></code> auf Ihrem Server. Manchmal funktioniert das, auch wenn Sie keinen Zugriff auf die Startseite und den [[Einstellungen-Block]] Ihrer Moodle-Site mehr haben.


<code php>
===In der Moodle-Konfigurationsdatei ''config.php''===
$CFG->debug = 6143;
$CFG->debugdisplay = 1;
</code>


For Moodle 2.0 the possible settings are as follows:
Ergänzen Sie folgende Zeilen in der Moodle-Konfigurationsdatei ''config.php'':


<code php>
<code php>
Zeile 91: Zeile 119:
</code>
</code>


Remember to remove those lines again when you have finished diagnosing your problem.
Denken Sie daran, diese Zeilen wieder zu löschen, sobald das Problem behoben ist!


===In the database===
===In der Moodle-Datenbank===


Using a tool like phpMyAdmin, execute the following SQL commands:
Mit Hilfe eines Werkzeugs wie phpMyAdmin führen Sie folgende SQL-Befehle aus:


<code sql>
<code sql>
UPDATE mdl_config SET value = 2047 WHERE name = 'debug';
UPDATE mdl_config SET value = 32767 WHERE name = 'debug';
UPDATE mdl_config SET value = 1 WHERE name = 'debugdisplay';
UPDATE mdl_config SET value = 1 WHERE name = 'debugdisplay';
</code>
</code>


To turn it back off, use the admin screens, or the commands:
Um das Debugging nach der Problembehandlung wieder zu deaktivieren, verwenden Sie folgende SQL-Befehle:


<code sql>
<code sql>
Zeile 109: Zeile 137:
</code>
</code>


(If you use a different database prefix, you will need to adjust those commands accordingly.)
(Wenn Ihre Datenbank ein anderes Präfix anstelle von ''mdl_'' verwenden, müssen Sie die Befehle entsprechend anpassen.)


==Siehe auch==
==Siehe auch==
Zeile 116: Zeile 144:


'''Beispiele''': [http://php.netbeans.org/ NetBeans], [http://www.jetbrains.com/phpstorm/ phpStorm], ...
'''Beispiele''': [http://php.netbeans.org/ NetBeans], [http://www.jetbrains.com/phpstorm/ phpStorm], ...
[[en:Debugging]]
[[es:Depuración]]
[[fr:Débogage]]

Aktuelle Version vom 19. April 2019, 12:36 Uhr

Als Administrator/in können Sie die Ausgabe von Debugging-Nachrichten auf der Seite Website-Administration (oder im Block Einstellungen) > Website-Administration) > Entwicklung > Debugging aktivieren.

Debugging-Nachrichten verwenden

Debugging-Nachrichten helfen bei der Analyse von Problemen oder Fehlern und sind für Entwickler/innen nützlich. Wenn Sie ein Problem mit Ihrer Moodle-Site haben und in einem der Support-Foren von moodle.org Hilfe suchen, kann es passieren, dass Entwickler/innen Sie bitten, das Debugging zu aktivieren, um mehr Informationen zur Analyse Ihres Problems zu erhalten. Standardmäßig werden in Moodle keinerlei Fehlerinformationen ausgegeben. Das Aktivieren des Debugging-Modus ist meistens ein erster Schritt zur Fehleranalyse- und behebung.

Debugging-Einstellungen

Für das Debugging können Sie folgende Einstellungen vornehmen:

Debug-Mitteilungen

Die Standardeinstellung ist KEINE: keine Fehlermeldungen oder Warnungen anzeigen. Weitere Optionen sind:

ALLE
alle notwendigen PHP-Debug-Mitteilungen anzeigen
MINIMAL
nur schwerwiegende Fehler anzeigen
NORMAL
Fehler, Warnungen und Bemerkungen anzeigen
DEVELOPER
besondere Moodle-Debug-Mitteilungen für Entwickler anzeigen

Es gibt selten Sitautionen, wo Sie den DEVELOPER-Modus benötigen, solange Sie nicht selbst als Entwickler/in arbeiten. Entwickler/innen sollten dagegen unbedingt die DEVELOPER-Option verwenden.

Wenn Sie eine Fehlermeldung in Moodle erhalten, kopieren und speichern Sie diese an einer geeigneten Stelle. Es wird dringend empfohlen, danach den Modus wieder auf KEINE zurückzustellen, da die Fehlermeldungen sonst Angriffsflächen für Hacker bieten.

Debug-Mitteilungen anzeigen

Wenn Sie diese Checkbox markieren, werden die Debug-Mitteilungen direkt im Browser angezeigt, andernfalls werden sie in den Server Logs gespeichert.

Debug-Mitteilungen zum E-Mail-Versand

Wenn Sie diese Checkbox markieren, werden umfassende Debug-Mitteilungen beim E-Mail-Versand über den SMTP-Server erstellt.

More tools for debugging outgoing mail (SMTP)

You can also use the config.php file to turn on more "tools" which will assist you with debugging the outgoing emails (and SMTP server configuration):

  • Redirect all outgoing emails to a specific address:

// Divert all outgoing emails to this address to test and debug emailing features // $CFG->divertallemailsto = 'root@localhost.local'; // NOT FOR PRODUCTION SERVERS!

  • Turn on the CRON debugging and run CLI cron.php script.

// Force developer level debug and add debug info to the output of cron // $CFG->showcrondebugging = true; And then use SSH (or putty.exe, on windows) to run: you@moodle-server(/var/www/html/moodle)# php admin/cli/cron.php

  • Turn on verbose SMTP debugging and output it into system's error_log (code hack):

As suggested on Moodle's discussion forums: Open lib/moodlelib.php L5379 and change it to: if (!empty($CFG->debugsmtp)) { 

   $mailer->SMTPDebug = 1;  // 0 - no debug ... 4 - low level full debug
   $mailer->Debugoutput = "error_log";

} See more info about SMTPDebug parameters & Debugoutput parameters, Set-up mailcatcher (https://mailcatcher.me/).

Performance

wenn Sie diese Checkbox markieren, dann wird beim Standard-Design (und einigen anderen Designs) in der Fußzeile eine Information über die Geschwindigkeit angezeigt. Zu diesen Informationen gehören die Ladezeit für eine Moodle-Seite, der benötigte Speicherbedarf, die CPU-Last und eine Cache-Information.

Wenn Sie folgenden Code in Ihre Moodle-Konfigurationsdatei config.php einfügen, dann werden außerdem die Datenbankabfragen gezählt: define('MDL_PERF', true); define('MDL_PERFDB', true); define('MDL_PERFTOLOG', true); define('MDL_PERFTOFOOT', true);

Dieser Code gehört in die Konfigurationsdatei, weil Moodle Datnabnkabfragen durchführt, bevor die Konfigurationsinformation in die datenbank geladen wird.

Herkunft der Texte anzeigen

Diese Einstellung ist für Übersetzer/innen nützlich. Sometimes ?strings=1 should be added; other times &strings=1. See the Wikipedia article Query string for details.

Prüflinks anzeigen

Wenn Sie diese Checkbox markieren, werden Links zu externen Validierungsservern in der Fußzeile angezeigt. Möglicherweise müssen Sie einen neuen Nutzer mit dem Anmeldenamen w3cvalidator erstellen und den Gastzugang freischalten. Wenn Sie diese Funktionalität aktivieren, sind unauthorisierte Serverzugriffe erlaubt, deshalb wird vom Einsatz auf Produktivsystemen dringend abgeraten.

Seiteninformation anzeigen

Wenn Sie diese Checkbox markieren, werden Seiteninformationen in der Fußzeile angezeigt.

SQL-Abfragen debuggen

You can add (turn ON) any of the following dboptions in your config.php files, which log different types of SQL queries into mdl_log_queires table:

  • logall - log all queries - suitable only for developers, causes high server loads and NOT recommended for production.
  • logslow - log queries that take longer than specified number of seconds (float values are accepted).
  • logerrors - log all error queries.

Full sample: $CFG->dboptions = array ( 

 //'logall'   => true,
 'logslow'  => 5,
 'logerrors'  => true,

);


Was mache ich, wenn ich keinen Zugriff auf die Debugging-Seite habe?

Wenn Sie eine Fehlermeldung erhalten und gar nicht mehr auf die Debugging-Seite gelangen, um den Debug-Modus zu aktivieren, dann können Sie das Debugging auch manuell einschalten:

Direkt über die URL

Die Debugging-Seite erreichen Sie über die direkte URL http://.../admin/settings.php?section=debugging auf Ihrem Server. Manchmal funktioniert das, auch wenn Sie keinen Zugriff auf die Startseite und den Einstellungen-Block Ihrer Moodle-Site mehr haben.

In der Moodle-Konfigurationsdatei config.php

Ergänzen Sie folgende Zeilen in der Moodle-Konfigurationsdatei config.php:

// Force a debugging mode regardless the settings in the site administration // @error_reporting(1023); // NOT FOR PRODUCTION SERVERS! @ini_set('display_errors', '1'); // NOT FOR PRODUCTION SERVERS! $CFG->debug = 38911; // DEBUG_DEVELOPER // NOT FOR PRODUCTION SERVERS! $CFG->debugdisplay = true; // NOT FOR PRODUCTION SERVERS!

// You can specify a comma separated list of user ids that that always see // debug messages, this overrides the debug flag in $CFG->debug and $CFG->debugdisplay // for these users only. $CFG->debugusers = '2';

Denken Sie daran, diese Zeilen wieder zu löschen, sobald das Problem behoben ist!

In der Moodle-Datenbank

Mit Hilfe eines Werkzeugs wie phpMyAdmin führen Sie folgende SQL-Befehle aus:

UPDATE mdl_config SET value = 32767 WHERE name = 'debug'; UPDATE mdl_config SET value = 1 WHERE name = 'debugdisplay';

Um das Debugging nach der Problembehandlung wieder zu deaktivieren, verwenden Sie folgende SQL-Befehle:

UPDATE mdl_config SET value = 0 WHERE name = 'debug'; UPDATE mdl_config SET value = 0 WHERE name = 'debugdisplay';

(Wenn Ihre Datenbank ein anderes Präfix anstelle von mdl_ verwenden, müssen Sie die Befehle entsprechend anpassen.)

Siehe auch

  • Entwickler/innen können auch XDEBUG verwenden, um mit Hilfe einer XDEBUG Client Applikation tiefer in den Code einzudringen. XDEBUG wird als Module im Apache Webserver installiert wird.

Beispiele: NetBeans, phpStorm, ...

Abgerufen von „https://docs.moodle.org/37/de/index.php?title=Debugging&oldid=19190“
Powered by MediaWiki