dams Fri Feb 9 05:46:56 2001 EDT Added files: /phpdoc/fr/functions mnogosearch.xml Log: Translation
Index: phpdoc/fr/functions/mnogosearch.xml +++ phpdoc/fr/functions/mnogosearch.xml <reference id="ref.mnogo"> <title>mnoGoSearch</title> <titleabbrev>mnoGoSearch</titleabbrev> <partintro> <simpara> Ces fonctions donnent l'accès à mnoGoSearch (anciennement UdmSearch), moteur de recherche du monde libre. Pour pouvoir les utiliser, vous devez inclure le support en ajoutant l'option <option role="configure">--with-mnogosearch</option>. Si vous utilisez cette option sans indiquer le chemin jusqu'à mnogosearch, PHP essaiera de le trouver dans le dossier <filename>/usr/local/mnogosearch</filename>. Si vous avez installé mnogosearch dans un autre endroit, vous devez l'indiquer comme ceci : <option role="configure">--with-mnogosearch=DIR</option>. </simpara> <note> <para> PHP supporte naturellement MySQL. Il faut savoir que mnoGoSearch n'est pas compatible avec la librairie interne de PHP, et ne peut fonctionner qu'avec les librairies génériques MySQL. Par conséquent, si vous utilisez mnoGoSearch avec MySQL, indiquez le dossier d'installation de MySQL durant la configuration avec l'option : <option role="configure">--with-mnogosearch --with-mysql=/usr</option>. </para> </note> <simpara> Pour utiliser ces fonctions, vous devez installer les verions 3.1.9 ou plus récente de mnoGoSearch. </simpara> <simpara> Plus de détails sur le site officiel de mnoGoSearch : <ulink url="&url.mnogo">&url.mnogo;</ulink>. </simpara> </partintro> <refentry id="function.Udm_Alloc_Agent"> <refnamediv> <refname>Udm_Alloc_Agent</refname> <refpurpose>Alloue une session mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_alloc_agent</function></funcdef> <paramdef>string <parameter>dbaddr</parameter></paramdef> <paramdef>string <parameter> <optional>dbmode</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_alloc_agent</function> retourne un identifiant d'agent mnogosearch en cas de succès, et <literal>FALSE</literal> sinon. Cette fonction crée une session avec les paramètres de base de données. </para> <note> <para> En réalité, <function>udm_alloc_agent</function> n'ouvre pas de connexion, et donc, ne vérifie ni le nom d'utilisateur, ni le mot de passe. </para> </note> </refsect1> </refentry> <refentry id="function.Udm_Set_Agent_Param"> <refnamediv> <refname>Udm_Set_Agent_Param</refname> <refpurpose>Définit les paramètres de session mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef><function>udm_set_agent_param</function></funcdef> <paramdef>int <parameter>agent</parameter></paramdef> <paramdef>int <parameter>var</parameter></paramdef> <paramdef>string <parameter>val</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_alloc_agent</function> retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'erreur. <function>udm_alloc_agent</function> définit les paramètres de session mnoGoSearch. </para> <para> Les paramètres suivants et leur valeur sont supportés : </para> <para> <parameter>UDM_PARAM_PAGE_NUM</parameter> sert à spécifier le numéro de page de résultat (les résultats sont retournés par pages, en commencant à la page 0, avec <parameter>UDM_PARAM_PAGE_SIZE</parameter> résultats par page). </para> <para> <parameter>UDM_PARAM_PAGE_SIZE</parameter> - nombre de résultats par page. </para> <para> <parameter>UDM_PARAM_SEARCH_MODE</parameter> - mode de recherche. Les constantes suivante sont définies : <parameter>UDM_MODE_ALL</parameter> - recherche tous les mots; <parameter>UDM_MODE_ANY</parameter> - recherche l'un des mots; <parameter>UDM_MODE_BOOL</parameter> - requête booléenne. </para> <para> <parameter>UDM_PARAM_CACHE_MODE</parameter> - active ou désactive le cache de recherche. Valeurs acceptées : <parameter>UDM_CACHE_ENABLED</parameter>, <parameter>UDM_CACHE_DISABLED</parameter> </para> <para> <parameter>UDM_PARAM_TRACK_MODE</parameter> - active ou désactive le mode "trackquery". Valeurs acceptées : <parameter>UDM_TRACK_ENABLED</parameter>, <parameter>UDM_TRACK_DISABLED</parameter> </para> <para> <parameter>UDM_PARAM_CHARSET</parameter> - définit le jeu de caractère local. Les valeurs possibles sont celles supportées par mnoGoSearch : <literal>koi8-r</literal>, <literal>cp1251</literal>, ... </para> <para> <parameter>UDM_PARAM_STOPFILE</parameter> - définit le nom et le chemin jusqu'aux fichier de mots interdits ("stopwords") : il y a une légère différence avec mnoGoSearch. Si mnoGoSearch est configuré avec un chemin relatif, ou sans chemin, alors il cherchera ce fichier en fonction de <parameter>UDM_CONF_DIR</parameter>. Alors que le module recherche le fichier dans le chemin courant, c'est à dire le chemin du script exécuté. </para> </refsect1> </refentry> <refentry id="function.Udm_Add_Search_Limit"> <refnamediv> <refname>Udm_Add_Search_Limit</refname> <refpurpose>Définit diverses limites de recherche</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef><function>udm_add_search_limit</function></funcdef> <paramdef>int <parameter>agent</parameter></paramdef> <paramdef>int <parameter>var</parameter></paramdef> <paramdef>string <parameter>val</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_add_search_limit</function> retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'erreur. </para> <note> <para> Cette fonction n'est pas implémentée, mais il est prévue qu'elle le soit. Elle définira alors diverses restrictions de recherche telles que par catégorie, par étiquette, par date.., de manière analogue <parameter>Udm_Set_Agent_Param</parameter>. </para> </note> </refsect1> </refentry> <refentry id="function.Udm_Find"> <refnamediv> <refname>Udm_Find</refname> <refpurpose>Effectue une recherche</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_find</function></funcdef> <paramdef>int <parameter>agent</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_add_search_limit</function> retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> en cas d'erreur. </para> <para> La recherche en elle-même. Le premier argument <parameter>agent</parameter> est la session, le second est la <parameter>query</parameter>. Pour rechercher, entrez les mots avec lesquels que vous voulez faire une recherche, puis cliquez sur le bouton d'envoi. Par exemple, "<literal>mysql odbc</literal>". Vous ne devez pas utiliser de guillemets doubles <literal>"</literal>, car ils sont utilisés par mnoGoSearch pour séparer une requête en mots. Avec l'exemple ci-dessus, mnoGoSearch va rechercher les pages contenant "mysql" et/ou "odbc". Les meilleures réponses seront classées en premier, et affichées en tête de liste. Si vous selectionez le mode de recherche "tous" ("ALL"), la recherche va retourner les documents qui contiennent l'un ou l'autre des mots que vous avez entré. Dans le cas où vous utilisez le mode "ANY", la recheche retourne la lsite des documents qui contiennent l'un ou l'autre des mots. Si vous voulez accéder aux fonctions avancées de recherche, vous pouvez utiliser le mode "BOOL", qui vous permet d'entrer directement des requêtes. </para> <para> mnoGoSearch utilise les opérateurs booléean suivants : </para> <para> & - AND, ET logique. Par exemple, "mysql & odbc". mnoGoSearch recherche toutes les URL qui contiennent à la fois les mots "mysql" et "odbc". </para> <para> | - OR, OU logique. Par exemple, "mysql | odbc". mnoGoSearch recherche toutes les URL qui contiennent soit "mysql", soit "odbc". </para> <para> ~ - NOT, NON logique. Par exemple, "mysql & ~odbc". mnoGoSearch recherche toutes les URL qui contiennent le mot "mysql" mais ne contiennent pas le mot "odbc". Attention : la requête "~odbc" ne trouvera rien! </para> <para> () - Groupage de commandes pour les requêtes complexes : par exemple, "(mysql | msql) & ~postgres". Le mode par requête est simple et puissant à la fois. Vous pouvez utiliser les commandes booléennes habituelles avec ce mode. </para> </refsect1> </refentry> <refentry id="function.Udm_Get_Res_Param"> <refnamediv> <refname>Udm_Get_Res_Param</refname> <refpurpose>Lit les paramètres de résultats mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_get_res_param</function></funcdef> <paramdef>int <parameter>res</parameter></paramdef> <paramdef>int <parameter>param</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_get_res_param</function> retourne les paramètres de résultat en cas de succès, <literal>FALSE</literal> en cas d'erreur. </para> <para> Le paramètre <parameter>res</parameter> est un identifiant de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. </para> <para> Le paramètre <parameter>param</parameter> peut prendre les valeurs suivantes : </para> <para> <parameter>UDM_PARAM_NUM_ROWS</parameter> - nombre de liens trouvés dans la page courante. Il est égal à <parameter>UDM_PARAM_PAGE_SIZE</parameter> pour toutes les pages sauf pour la dernière, où il peut être inférieur. </para> <para> <parameter>UDM_PARAM_FOUND</parameter> - nombre total de résultats trouvés. </para> </refsect1> </refentry> <refentry id="function.Udm_Get_Res_Field"> <refnamediv> <refname>Udm_Get_Res_Field</refname> <refpurpose>Lit un champs de résultat mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_get_res_field</function></funcdef> <paramdef>int <parameter>res</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> <paramdef>int <parameter>field</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_alloc_agent</function> retourne la valeur du champs <parameter>field</parameter> dans la ligne <parameter>row</parameter>, du résultat <parameter>res</parameter>, et <literal>FALSE</literal> sinon. </para> <para> Le paramètre <parameter>res</parameter> est un identifiant de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. </para> <para> Le paramètre <parameter>row</parameter> est le numéro du lien dans la page courante. Il peut valoir de 0 jusqu'à <parameter>UDM_PARAM_NUM_ROWS</parameter>. </para> <para> Le paramètre <parameter>field</parameter> est l'identifiant de champs, et peut prendre l'une des valeurs suivantes : </para> <para> <parameter>UDM_FIELD_URL</parameter> - URL </para> <para> <parameter>UDM_FIELD_CONTENT</parameter> - "Content-type" : type MIME de contenu </para> <para> <parameter>UDM_FIELD_TITLE</parameter> - Titre de la page </para> <para> <parameter>UDM_FIELD_KEYWORDS</parameter> - Les mots clés, contenus dans les balises meta de la page. </para> <para> <parameter>UDM_FIELD_DESC</parameter> - La descriptioncontenus dans les balises meta de la page. </para> <para> <parameter>UDM_FIELD_TEXT</parameter> - Le corps de la page. </para> <para> <parameter>UDM_FIELD_SIZE</parameter> - La taille de la page. </para> <para> <parameter>UDM_FIELD_URLID</parameter> - Un identifiant unique. </para> <para> <parameter>UDM_FIELD_SCORE</parameter> - Le score de la page. </para> <para> <parameter>UDM_FIELD_MODIFIED</parameter> - La date de dernière modification, sous la forme d'un timestamp. </para> </refsect1> </refentry> <refentry id="function.Udm_Free_Res"> <refnamediv> <refname>Udm_Free_Res</refname> <refpurpose>Libère un résultat mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_free_res</function></funcdef> <paramdef>int <parameter>res</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_free_res</function> retourne <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. </para> <para> Le paramètre <parameter>res</parameter> est un identifiant de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. </para> <para> <function>udm_free_res</function> libère la mémoire de tous les résultats générés. </para> </refsect1> </refentry> <refentry id="function.Udm_Free_Agent"> <refnamediv> <refname>Udm_Free_Agent</refname> <refpurpose>Détruit une session mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_free_agent</function></funcdef> <paramdef>int <parameter>agent</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_free_res</function> retourne <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. </para> <para> Le paramètre <parameter>res</parameter> est un identifiant de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. </para> <para> <function>udm_free_agent</function> détruit l'agent de recherche créé par <function>udm_alloc_agent</function>. </para> </refsect1> </refentry> <refentry id="function.Udm_Errno"> <refnamediv> <refname>Udm_Errno</refname> <refpurpose>Numéro d'erreur mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>udm_errno</function></funcdef> <paramdef>int <parameter>agent</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_errno</function> retourne le numéro d'erreur mnoGoSearch, ou bien <literal>0</literal> sinon. </para> <para> Le paramètre <parameter>agent</parameter> est un identifiant de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. </para> <para> <function>udm_errno</function> retourne le numéro de l'erreur généré par l'agent <parameter>agent</parameter>. </para> </refsect1> </refentry> <refentry id="function.Udm_Error"> <refnamediv> <refname>Udm_Error</refname> <refpurpose>Message d'erreur mnoGoSearch</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>udm_error</function></funcdef> <paramdef>int <parameter>agent</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>udm_errno</function> retourne le message d'erreur mnoGoSearch, ou bien une chaîne vide sinon. </para> <para> Le paramètre <parameter>agent</parameter> est un identifiant de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. </para> <para> <function>udm_error</function> retourne le numéro de l'erreur généré par l'agent <parameter>agent</parameter>. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->