Changes

From SME Server
Jump to navigationJump to search

Koozali SME Server Debugging/fr (view source)

Revision as of 15:46, 18 August 2024

175 bytes removed ,  18 August
no edit summary
Line 134: Line 134:  
====Mappage pour l'édition====
 
====Mappage pour l'édition====
   −
Si vous souhaitez également éditer du code, vous devrez configurer une forme de mappage de fichiers entre l'URI envoyée par le débogueur et votre configuration « Serveur » dans Komodo
+
Si vous souhaitez également éditer du code, vous devrez configurer une forme de mappage de fichiers entre l'URI envoyée par le débogueur et votre configuration « Serveur » dans Komodo.
   −
Notez que sans certaines des bibliothèques esmith installées localement, vous recevrez des avertissements indiquant que vous ne parviendrez pas à localiser certains fichiers, mais ceux-ci peuvent être ignorés en toute sécurité.
+
Notez que sans certaines des bibliothèques e-smith installées localement, vous recevrez des avertissements indiquant que vous ne parviendrez pas à localiser certains fichiers, mais ceux-ci peuvent être ignorés en toute sécurité.
   −
Dans les préférences de Komodo, vous devez configurer un compte serveur/distant pour le serveur distant. par exemple :
+
Dans les préférences de Komodo, vous devez configurer un compte serveur/distant pour le serveur distant, par exemple :
   −
Compte distant : Test_v10
+
Compte distant : Test_v10
−
Type : SCP
+
Type : SCP
−
Port : 2222
+
Port : 2222
−
Nom d'utilisateur : root
+
Nom d'utilisateur : root
−
Mot de passe : somepass (ou utilisez des clés SSH)
+
Mot de passe : monmotdepasse (ou également utilisez des clés SSH)
    
Vous pouvez ensuite configurer un mappage similaire à celui-ci :
 
Vous pouvez ensuite configurer un mappage similaire à celui-ci :
−
  −
URI : file://v9-test/
  −
Maps To : scp://Test_v9/
  −
  −
Ou
  −
  −
URI : file://v9-test/etc/e-smith
  −
Maps To : scp://Test_v9/etc/e-smith
  −
  −
Vous pouvez être plus précis sur les répertoires si vous le souhaitez. N'oubliez pas que vous héritez des autorisations du serveur : vous ne pouvez pas enregistrer un fichier en lecture seule sur le serveur !
  −
  −
  −
Mapping for editing====
  −
  −
Should you wish to actually edit code as well you will need to set up some form of file mapping between the URI that the debugger sends and your 'Server' setup in Komodo
  −
  −
Note that without some of the esmith libraries installed locally you will get some warnings about being unable to locate certain files but these can safely be ignored.
  −
  −
In Komodo preferences you need to setup a Server/Remote Account for the remote server. e.g.
  −
  −
Remote Account : Test_v10
  −
Type: SCP
  −
Port: 2222
  −
Username: root
  −
Pass: somepass (or alternatively use SSH keys)
  −
  −
You can then set up a mapping similar to this:
      
  URI : file://v9-test/
 
  URI : file://v9-test/
 
  Maps To : scp://Test_v9/
 
  Maps To : scp://Test_v9/
   −
Or
+
Ou :
    
  URI : file://v9-test/etc/e-smith
 
  URI : file://v9-test/etc/e-smith
 
  Maps To : scp://Test_v9/etc/e-smith
 
  Maps To : scp://Test_v9/etc/e-smith
   −
You could be more specific about the directories should you require. Remember that you inherit the server permissions - you cannot save a file that is Read Only on the server !
+
Vous pouvez être plus précis sur les répertoires si vous le souhaitez. N'oubliez pas que vous héritez des autorisations du serveur : vous ne pouvez pas enregistrer un fichier en lecture seule sur le serveur !
   −
====Local file mapping====
+
====Mappage de fichiers locaux====
 +
J'ai réussi à le faire en utilisant sshfs :
   −
I seemed to have managed this using sshfs:
+
sshfs -p 2222 root@192.168.10.199:/ ~/Mounts/unRepertoire
   −
shfs -p 2222 root@192.168.10.199:/ ~/Mounts/somedirectory
+
Vous pouvez ensuite accéder aux fichiers normalement et il est facile de mapper la télécommande aux fichiers « locaux ».
   −
You can then access the files normally and it is easy to map the remote to the 'local' files.
+
====Rangement a posteriori====
−
 
  −
====Tidying up afterwards====
  −
 
  −
Either reboot the server or use the following:
      +
Redémarrez le serveur ou utilisez la méthode suivante :
 
  export PERL5LIB=/usr/local/lib64/perl5:/usr/local/share/perl5:/usr/lib64/perl5/vendor_perl:/usr/share/perl5/vendor_perl
 
  export PERL5LIB=/usr/local/lib64/perl5:/usr/local/share/perl5:/usr/lib64/perl5/vendor_perl:/usr/share/perl5/vendor_perl
 
  export PERLDB_OPTS=
 
  export PERLDB_OPTS=
 
  export DBGP_IDEKEY=jdoe
 
  export DBGP_IDEKEY=jdoe
   −
==== Perl CGI Debugging====
+
====Débogage CGI Perl====
   −
[[Debugging CGI programs on live production servers can seriously impair performance. You have been warned !!]]
+
[[Le débogage des programmes CGI sur des serveurs de production en direct peut sérieusement nuire aux performances. Vous êtes prévenu !!]]
   −
Please see here for further details:
+
Veuillez consulter ici pour plus de détails :
    
http://docs.komodoide.com/Manual/debugperl#debugging-perl-komodo-ide-only_configuring-perl-for-cgi-debugging
 
http://docs.komodoide.com/Manual/debugperl#debugging-perl-komodo-ide-only_configuring-perl-for-cgi-debugging
   −
You would need a custom httpd.conf fragment. I used 46PerlDebug with these options (configure to suit)
+
Vous aurez besoin d'un fragment httpd.conf personnalisé. J'ai utilisé 46PerlDebug avec ces options (configurer en conséquence) :
    
  SetEnv PERL5LIB "/opt/dbgp/perllib:$PERL5LIB"
 
  SetEnv PERL5LIB "/opt/dbgp/perllib:$PERL5LIB"
Line 215: Line 186:  
  SetEnv DBGP_IDEKEY "user"
 
  SetEnv DBGP_IDEKEY "user"
   −
You should now be able access your cgi-script and debug accordingly.
+
Vous devriez maintenant pouvoir accéder à votre script cgi et déboguer en conséquence.
   −
However, having tried it you cannot use this on server-manager panels because perl is setuid.
+
Cependant, après l'avoir essayé, vous ne pouvez pas l'utiliser sur les panneaux du gestionnaire de serveur car Perl est « setuid ».
   −
It could be used in other scenarios, but not server-manager.
+
Il pourrait être utilisé dans d'autres scénarios, mais pas dans le gestionnaire de serveur.
   −
===Multiple machine debug proxy===
+
===Proxy de debogage multi-machines===
    
TBA
 
TBA
   −
Notes are here:
+
Les notes sont ici :
 
http://docs.komodoide.com/Manual/debugger#debugging-programs-komodo-ide-only_remote-debugging_debugger-proxy
 
http://docs.komodoide.com/Manual/debugger#debugging-programs-komodo-ide-only_remote-debugging_debugger-proxy
   −
===Perl with Visual Studio===
+
===Perl avec Visual Studio===
   −
{{Note box|To be refined}}
+
{{Note box|type=Note : |à affiner.}}
   −
Still working on this but we need Perl Language Server
+
Nous travaillons toujours sur ce sujet, mais nous avons besoin du serveur de langage Perl.
   −
On your server:
+
Sur votre serveur :
    
   yum --enablerepo=* install gcc gcc-c++ perl-App-cpanminus perl-AnyEvent-AIO perl-Coro
 
   yum --enablerepo=* install gcc gcc-c++ perl-App-cpanminus perl-AnyEvent-AIO perl-Coro
Line 244: Line 215:  
   cpanm Perl::LanguageServer
 
   cpanm Perl::LanguageServer
   −
On your workstation:
+
Sur votre station de travail :
 +
* configurez vos serveurs distants à l'aide des clés ssh dans .ssh/config ;
 +
* installez Visual Studio Code Remote Explorer ;
 +
* redémarrez ;
 +
* accédez à Remote Explorer et vous devriez voir votre liste de serveurs ;
 +
* ouvrez dans la fenêtre actuelle ou une nouvelle ;
 +
* sélectionnez la plateforme et laissez VS Code s'installer ;
 +
* accédez à l'explorateur de fichiers ;
 +
* ouvrir le dossier ;
 +
* il vous suggérera d'ouvrir dans /root/ mais je trouve plus facile d'ouvrir dans / ;
 +
* cliquez sur OK et vos dossiers apparaîtront à gauche ;
 +
* accédez à votre fichier et ouvrez-le ;
 +
* définissez un point d'arrêt en haut ;
 +
* accédez maintenant à Debug, Ajoutez une Configuration et acceptez les valeurs par défaut ;
 +
* exécutez maintenant Debug et vous devriez voir le code s'arrêter à l'un de vos points d'arrêt.
   −
* Set up your remote servers using ssh keys in .ssh/config
+
Vous pouvez maintenant parcourir votre code.
−
* Install Visual Studio Code Remote Explorer
  −
* Restart
  −
* Go to Remote Explorer and you should see your server list
  −
* Open in Current or New window
  −
* Select the platform and let VS Code install itself
  −
* Go to File explorer
  −
* Open Folder
  −
* It will suggests opening in /root/ but I find it easier to open in /
  −
* Click OK and your folders will appear left
  −
* Go to your file and open it
  −
* Set a break point near the top
  −
* Now go to Debug, Add a Configuration, and accept the defaults
  −
* Now run the Debug and you should see the code stop at one of your break points
      +
===Débogage PHP à distance===
 +
Vous pouvez déboger sur votre station de travail locale mais il est extrèmememnt utile de pouvoir déboger directement dans l'environnement du serveur.
 +
Vous pouvez avoir une version de PHP installée sur votre ordinateur mais en avoir une différente qui tourne sur le serveur et vous pouvez avoir une configuration différente sur le serveur.
   −
You can now step through your code.
+
D'abord, vous avez besoin d'installer les paquets xdebug, par exemple :
   −
===PHP remote debugging===
+
{{Note box|type=Note : |Xdebug 3 n'est pas disponible pour les versions de PHP inférieures à 7.2. Vous aurez besoin de php54-php-pecl-xdebug.}}
−
 
  −
You can debug on your local workstation but it is extremely useful to be able to debug direct on the server environment.
  −
You may have one PHP version installed on your desktop but be running a different one on the server, and you may have a different server setup.
  −
 
  −
First you need to install the xdebug packages eg:
  −
 
  −
{{Note box|Xdebug 3 is not available for PHP versions less than 7.2 You will need php54-php-pecl-xdebug}}
      
  yum install php74-php-pecl-xdebug3
 
  yum install php74-php-pecl-xdebug3
 
  yum install php80-php-pecl-xdebug3
 
  yum install php80-php-pecl-xdebug3
   −
Or
+
Oo :
    
  yum install php*php-pecl-xdebug3
 
  yum install php*php-pecl-xdebug3
   −
Next you need a small template fragment to enable remote debugging.
+
Ensuite, vous avez besoin d’un petit fragment de modèle pour permettre le débogage à distance.
    
=====Xdebug 2=====
 
=====Xdebug 2=====
Line 287: Line 255:  
  nano /etc/e-smith/templates-custom/etc/php.ini/90XdebugSettings  
 
  nano /etc/e-smith/templates-custom/etc/php.ini/90XdebugSettings  
   −
Add this:
+
Ajouter ceci :
    
  [Debugger]
 
  [Debugger]
Line 302: Line 270:  
=====Xdebug 3 =====
 
=====Xdebug 3 =====
   −
New syntax.
+
Nouvelle syntaxe.
    
https://xdebug.org/docs/upgrade_guide
 
https://xdebug.org/docs/upgrade_guide
Line 319: Line 287:       −
Expand templates and restart services:
+
Expandre les modèles et redémarrer les services :
    
  signal-event webapps-update
 
  signal-event webapps-update
   −
We should see Xdebug here
+
Nous devrions voir Xdebug ici :
    
  php74 -v
 
  php74 -v
Line 332: Line 300:  
     with Xdebug v2.9.8, Copyright (c) 2002-2020, by Derick Rethans
 
     with Xdebug v2.9.8, Copyright (c) 2002-2020, by Derick Rethans
   −
Or like this:
+
Ou comme cela :
    
  php80 -v
 
  php80 -v
−
PHP 8.0.19 (cli) (built: May 10 2022 08:07:35) ( NTS gcc x86_64 )
+
PHP 8.0.19 (cli) (built: May 10 2022 08:07:35) ( NTS gcc x86_64 )
−
Copyright (c) The PHP Group
+
Copyright (c) The PHP Group
−
Zend Engine v4.0.19, Copyright (c) Zend Technologies
+
Zend Engine v4.0.19, Copyright (c) Zend Technologies
 
     with Zend OPcache v8.0.19, Copyright (c), by Zend Technologies
 
     with Zend OPcache v8.0.19, Copyright (c), by Zend Technologies
 
     with Xdebug v3.1.5, Copyright (c) 2002-2022, by Derick Rethans
 
     with Xdebug v3.1.5, Copyright (c) 2002-2022, by Derick Rethans
Gieres
3,072

edits

Retrieved from "https://wiki.koozali.org/Special:MobileDiff/43025"

Navigation menu