Edit Report a Bug

    udm_find

    (PHP 4 >= 4.0.5, PHP 5 < 5.1.0, PECL mnogosearch >= 1.0.0)

    udm_find — 検索を実行する

    説明

    udm_find ( resource $agent , string $query ) : resource

    検索を行います。

    検索を行います。最初の引数はセッション、次の引数はクエリ本体です。 検索の実行は、探す単語を入力し、投稿ボタンを押すだけで可能です。 例えば、"mysql odbc"。この例で引用符は他のテキストから区別するために 使用されており、クエリに引用符 " を使用する必要はありません。 mnoGoSearch は、単語 "mysql" および/または単語 "odbc" を含む全ての 文書を見付けます。最も大きな重みを有する文書が最初に表示されます。 検索モードに ALL を使用している場合、検索は入力した単語(とその他の 単語)を共に含む文書を返します。モードANYを使用している場合、検索は、 入力した単語のどれかを含む文書のリストを返します。より高度な結果を 得たい場合には、クエリ言語を使用することも可能です。この場合は、 検索フォームで検索モード "bool" を選択する必要があります。

    パラメータ

    agent

    udm_alloc_agent() をコールした際に得られたエージェント ID へのリンク。

    query

    mnoGoSearch では次の論理演算子が使用可能です。

    & - 論理積。例えば、"mysql & odbc"。 mnoGoSearch は、単語 "mysql" および単語 "odbc" を含む全ての URL を見付けます。

    | - 論理和。例えば、"mysql|odbc"。 mnoGoSearch は、単語 "mysql" または単語 "odbc"を含む全ての URL を見付けます。

    ~ - 論理否定。例えば、"mysql & ~odbc"。 mnoGoSearch は、単語 "mysql" を含み、同時に単語 "odbc" を含まない全てのURLを探します。~ は、指定した単語を 結果から除外するだけであることに注意してください。クエリ "~odbc" は何も見付けません!

    () - より複雑なクエリを作成するためのグループ化コマンド。例えば、 "(mysql | msql) & ~postgres"。クエリ言語は、簡単であり、 同時に強力です。クエリは通常の論理式と同等と考えてください。

    返り値

    成功した場合に結果リンク ID、失敗した場合に FALSE を返します。

    add a note add a note

    User Contributed Notes 2 notes

    up
    1
    sm_dev_mnogo at u5 dot com
    20 years ago
    For me (PHP 4.3.3, Mnogo 3.2.15 on FreeBSD) Mnogo doesn't work as described - but very well if done as in the PHP-template distributed by MnogoSearch

    I had huge problems getting Udm_Find(... to return anything at all.

    All the other calls worked, like udm_get_doc_count(...  but _find seemed to insist on returning nothing, no matter what I tried.

    However, I had actually a working installation of mnogo, using the PHP template, so it was just to find the difference in the, BTW impressive, work by Sergey 'gluke' Kartashoff.

    The result was surprising, see below. The parameter UDM_PARAM_QUERY is not mentioned in the manual

    <?php

      $q    ="help";
          // This is the real query. Note that Udm_find seems to
      // ignore it, despite the
      // description in the manual

          $udm_agent
            =Udm_Alloc_Agent('pgsql://me:secret@/mnogo_db/?dbmode=multi');
          // This is actually also contrary to the manual, but it
      // works. Also in the PHP-template it said
    /*
    if (Udm_Api_Version() >= 30204) {
        $dbaddr='mysql://mnogo:mnogo@/mnogo/?dbmode=single';
    } else {
        $dbaddr='mysql://mnogo:mnogo@/mnogo/';
        $dbmode='single';
    }
    */
    // which contradicts the manual for never versions

          $iDoItAsInTheManual = true;  //Set to false and it works

          if ($iDoItAsInTheManual)
        {
            $res=Udm_Find($udm_agent, $q);
        }
      else 
            // This works:
            {
            Udm_Set_Agent_Param($udm_agent,UDM_PARAM_QUERY,$q);
            $res=Udm_Find($udm_agent,"anything here, makes no difference!!");
        }

          $url = udm_get_res_field(
                                        $res,         //resource res,
                                        0,                 // int row,
                                        UDM_FIELD_URL     // int field
                                        );
      echo     $url;

          // Fails if $iDoItAsInTheManual==true, otherwise it works fine

    ?>

    I don't know where something has gone wrong but I hope this may help someone save a little time.
    up
    0
    matt at nowhere dot dot
    21 years ago
    Here is a small snipet of code that will perform a search on mnogosearch and (in not so pretty a way) display the results.  Note that it appears that UDM_PARAM_FIRST_DOC starts at 1, but perhaps should be 0.
    <?php
    $searchText     = trim($_GET['search']);
    $mnogo = udm_alloc_agent ('mysql://me:secret@localhost/mnogosearch/');
    $mResult = udm_find($mnogo,$searchText);
    $totalMatches = udm_get_res_param ($mResult,UDM_PARAM_FOUND);
    $pageSize = udm_get_res_param ($mResult,UDM_PARAM_NUM_ROWS);
    $firstRow = udm_get_res_param ($mResult,UDM_PARAM_FIRST_DOC);
    $lastRow = udm_get_res_param ($mResult,UDM_PARAM_LAST_DOC);
    echo     "Your search for <b>$searchText</b> resulted in <b>$totalMatches</b> matches";
    echo     "The result set (pagesize) is <b>$pageSize</b>\n";
    echo     "The first doc is row <b>$firstRow</b> and the last doc is <b>$lastRow</b>\n";
    $row=0;
    for (    $i=$firstRow-1;$i<$lastRow;$i++) {
            $row++;
        echo     "Match $row:";
        echo     'Url: ';
            $url = udm_get_res_field ($mResult,$i,UDM_FIELD_URL);
        echo     "<a href=\"$url\">$url</a>";
        echo     "\nTitle: <b>";
        echo     udm_get_res_field ($mResult, $i,UDM_FIELD_TITLE);
        echo     "</b>\nMeta Desc:";
        echo     udm_get_res_field ($mResult, $i,UDM_FIELD_DESC);
        echo     "\nPage Text: <b>\n";
        echo     udm_get_res_field ($mResult, $i,UDM_FIELD_TEXT);
        echo     "</b>\n<hr>\n";
    }
    udm_free_res($mResult);
    udm_free_agent($mnogo);
    ?>
    add a note add a note
    To Top