readline_completion_function

(PHP 4, PHP 5, PHP 7, PHP 8)

readline_completion_function — 注册一个完成函数

说明

readline_completion_function(callable $function): bool

这个函数注册一个完成函数.这就像你在使用 Bash 时按 tab 键时你想要的功能一样

参数

function: 你必须提供一个已经存在的函数的名字并且可以接受命令行中的部分输入然后返回一些可能匹配的数组.

返回值

成功时返回 true，或者在失败时返回 false。

add a note

User Contributed Notes 5 notes

down

chris AT w3style DOT co UK ¶

12 years ago


A little bit of info regarding useful variables when writing your callback function.

There doesn't seem to be a way to set rl_basic_word_break_characters like with the pure C library, so as previous users have pointed out you'll only receive the current word in the input buffer within your callback.  If for example you're typing "big bro|ther", where the bar is the position of your cursor when you hit TAB, you'll receive (string) "brother" and (int) 4 as your callback parameters.

However, it is possible (easily) to get more useful information about what the user has typed into the readline buffer.  readline_info() is key here.  It will return an array containing:

"line_buffer" => (string)
   the entire contents of the line buffer (+ some bugs**)

"point" => (int)
   the current position of the cursor in the buffer

"end" => (int)
   the position of the last character in the buffer

So for the example above you'd get:

  * line_buffer => "big brother"
  * point => 7
  * end => 11

From this you can easily perform multi-word matches.

** NOTE: line_buffer seems to contain spurious data at the end of the string sometime.  Fortunately since $end is provided you can substr() it to get the correct value.

The matches you need to return are full words that can replace $input, so your algorithm might crudely look something like:

<?php

function your_callback($input, $index) {
  // Get info about the current buffer
  $rl_info = readline_info();
  
  // Figure out what the entire input is
  $full_input = substr($rl_info['line_buffer'], 0, $rl_info['end']);
  
  $matches = array();
  
  // Get all matches based on the entire input buffer
  foreach (phrases_that_begin_with($full_input) as $phrase) {
    // Only add the end of the input (where this word begins)
    // to the matches array
    $matches[] = substr($phrase, $index);
  }
  
  return $matches;
}

?>

down

cameron at cloudix dot co dot nz ¶

7 years ago


The readline extension can be a bit flakey due to bugs in libedit (PHP 5.3.10-1ubuntu3.15 with Suhosin-Patch (cli) (built: Oct 29 2014 12:19:04)).

I created many segfaults returning an empty array on the autocompletion function:

// Autocomplete
readline_completion_function(function($Input, $Index){
    
    global $Commands;
    
    // Filter Matches    
    $Matches = array();
    foreach(array_keys($Commands) as $Command)
        if(stripos($Command, $Input) === 0)
            $Matches[] = $Command;
    
    return $Matches;
});

I found adding an empty string to the matches array prevents the segfault:

// Autocomplete
readline_completion_function(function($Input, $Index){
    
    global $Commands;
    
    // Filter Matches    
    $Matches = array();
    foreach(array_keys($Commands) as $Command)
        if(stripos($Command, $Input) === 0)
            $Matches[] = $Command;
    
    // Prevent Segfault
    if($Matches == false)
        $Matches[] = '';
    
    return $Matches;
});

Hopefully this is helpful to someone.

down

overshoot.tv ¶

12 years ago


Note: the first argument passed to the registered function is NOT the whole command line as entered by the user, but only the last part, i.e. the part after the last space.


e.g.:

<?php

function my_readline_completion_function($string, $index) {

  // If the user is typing:

  // mv file.txt directo[TAB]

  // then:

  // $string = directo

  // the $index is the place of the cursor in the line:

  // $index = 19; 


  $array = array(

    'ls',

    'mv',

    'dar',

    'exit',

    'quit',

  );


  // Here, I decide not to return filename autocompletion for the first argument (0th argument).

  if ($index) {

    $ls = `ls`;

    $lines = explode("\n", $ls);

    foreach ($lines AS $key => $line) {

      if (is_dir($line)) {

        $lines[$key] .= '/';

      }

      $array[] = $lines[$key];

    }

  }

  // This will return both our list of functions, and, possibly, a list of files in the current filesystem.

 // php will filter itself according to what the user is typing.

  return $array;

}

?>

down

john at weider dot cc ¶

19 years ago


It seems that the registered function can accept 2 parameters, the first being the partial string, the second a number that when equal to zero indicates that the tab was hit on the first argument on the input. Otherwise it looks like the position within the string is returned.

This is neccessary information for processing shell command line input.

down

-3

david at acz dot org ¶

17 years ago


This function can simply return an array of all possible matches (regardless of the current user intput) and readline will handle the matching itself.  This is likely to be much faster than attempting to handle partial matches in PHP.

add a note

官方地址：https://www.php.net/manual/en/function.readline-completion-function.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像 PHP获取指定函数定义在哪个文件中及行号支持php7的性能采集扩展 adodb连接mysql多个数据库的问题

略微加速

PHP官方手册 - 互联网笔记

readline_completion_function

说明

参数

返回值

User Contributed Notes 5 notes