进度条

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 2.5,不再维护。

读这个页面的更新版本Symfob娱乐下载ony 6.3(当前的稳定版本)。

进度条

2.5

进度条的功能是在Symfony 2.5中引入的替代品ob娱乐下载进步的助手。

当执行执行长时间运行的命令,它可能有助于显示进度信息,更新你的命令运行:

显示进展细节,使用ProgressBar,通过它的单位总数,并推进进度执行命令:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
使用ob娱乐下载\组件\控制台\助手\ProgressBar;/ /创建一个新的进度条(50单位)美元进步=新ProgressBar (美元输出,50);/ /启动和显示进度条美元进步- >开始();美元我=0;而(美元我+ + <50){/ /……做一些工作/ /进度条1单位提前美元进步- >提前();/ /你也可以提前超过一个单位的进度条/ / $进展- >进步(3);}/ /确保进度为100%美元进步- >完成();

而不是推进(酒吧的步骤提前()方法),您也可以通过调用设置当前进展setCurrent ()方法。

谨慎

进度条只如果你的平台支持ANSI编码工作;在其他平台上,不生成输出。

如果你不知道提前的步数,只是省略参数在创建的步骤ProgressBar实例:

1
美元进步=新ProgressBar (美元输出);

的进展将被显示为一个动态浏览图示:

1 2 3 4 5 6 7 8 9
#没有马克斯步骤(显示像throbber) 0(> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -) 5(- - - - - - > - - - - - - - - - - - - - - - - - - - - - - -) 5(= = = = = = = = = = = = = = = = = = = = = = = = = = = =] #马克斯步骤定义0/3 (> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]0% 1/3 (= = = = = = = = = > - - - - - - - - - - - - - - - - - -]33% 3/3 [= = = = = = = = = = = = = = = = = = = = = = = = = = = =)100%

当你的任务完成后,别忘了打电话完成()为了确保进度条显示刷新完成100%。

请注意

如果你想要输出的东西在进度条时,调用clear ()第一。在你完成之后,调用显示()再次显示进度条。

自定义进度条

内置的格式

默认情况下,信息呈现在一个进度条取决于当前的冗长的水平OutputInterface实例:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
# OutputInterface: VERBOSITY_NORMAL (CLI没有冗长的旗帜)0/3 (> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]0% 1/3 (= = = = = = = = = > - - - - - - - - - - - - - - - - - -]33% 3/3 [= = = = = = = = = = = = = = = = = = = = = = = = = = = =]100% # OutputInterface:: VERBOSITY_VERBOSE (- v) 0/3(> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -] 0% 1秒1/3(= = = = = = = = = > - - - - - - - - - - - - - - - - - -]33% 1秒3/3[= = = = = = = = = = = = = = = = = = = = = = = = = = = =]100% 1秒# OutputInterface:: VERBOSITY_VERY_VERBOSE (vv) 0/3(> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -] 0% 1秒1/3(= = = = = = = = = > - - - - - - - - - - - - - - - - - -]33% 1秒3/3[= = = = = = = = = = = = = = = = = = = = = = = = = = = =]100% 1秒# OutputInterface:: VERBOSITY_DEBUG (-vvv) 0/3(> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -] 0% 1秒/ 1秒1.0 MB 1/3(= = = = = = = = = > - - - - - - - - - - - - - - - - - -] 33% 1秒/ 1秒1.0 MB 3/3[= = = = = = = = = = = = = = = = = = = = = = = = = = = =] 100% 1秒/ 1秒1.0 MB

请注意

如果你叫一个命令与安静的标志(q),进度条不会显示出来。

而不是依靠冗长的当前模式命令,您还可以通过强制格式setFormat ():

1
美元酒吧- >setFormat (“详细”);

内置的格式如下:

  • 正常的
  • 详细的
  • very_verbose
  • 调试

如果你不为你的进度条设置步骤的数量,使用_nomax变体:

  • normal_nomax
  • verbose_nomax
  • very_verbose_nomax
  • debug_nomax

自定义格式

而不是使用内置的格式,你也可以设置自己的:

1
美元酒吧- >setFormat (“%酒吧%”);

这个格式设置为只显示进度条本身:

1 2 3
> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - = = = = = = = = = > - - - - - - - - - - - - - - - - - - = = = = = = = = = = = = = = = = = = = = = = = = = = = =

一个进度条的格式是一个字符串,其中包含封闭与特定的占位符(一个名称%字符);的占位符替换基于当前进展。这是一个内置的占位符的列表:

  • 当前的:当前步骤;
  • 马克斯:步骤的最大数量(或0如果没有定义的最大值);
  • 酒吧:酒吧本身;
  • 百分比:完成的百分比(没有如果没有定义的最大值);
  • 运行:时间开始以来的进度条;
  • 剩下的:剩下的时间来完成任务(没有如果没有定义的最大值);
  • 估计:预计完成任务时间(没有如果没有定义的最大值);
  • 内存:当前内存使用量;
  • 消息:当前信息附加到进度条。

例如,下面是如何设置的格式是一样的调试一:

1
美元酒吧- >setFormat (' %电流最大% / % %(%酒吧%)% %:3 s % % %时间:6 s % / %估计:6 s % %记忆:6 s %’);

注意到:6部分添加到一些占位符吗?这就是你可以调整栏的外观(格式和对齐)。冒号后面的部分(:)是用于设置sprintf格式的字符串。

的消息占位符有点特殊,你必须自己设置值:

1 2 3 4 5 6 7 8 9 10
美元酒吧- >setMessage (任务开始的);美元酒吧- >开始();美元酒吧- >setMessage (“任务进展……”);美元酒吧- >提前();/ /……美元酒吧- >setMessage (“任务完成”);美元酒吧- >完成();

而不是设置一个进度条的格式对于一个给定的实例,您还可以定义全球格式:

1 2 3 4
ProgressBar::setFormatDefinition (“最低”,的进展:% % % %);美元酒吧=新ProgressBar (美元输出,3);美元酒吧- >setFormat (“最低”);

这段代码定义了一个新的最小的格式,你可以使用你的进度条:

1 2 3
进展:0%进度:33%进度:100%

提示

它几乎总是更好的重新定义内置格式而不是创造新的角色,允许显示自动改变基于命令的冗长的旗帜。

当定义一个新的风格,包含占位符,只可用已知的最大数量的步骤时,您应该创建一个_nomax变体:

1 2 3 4 5
ProgressBar::setFormatDefinition (“最低”,“剩下的% % % % % %”);ProgressBar::setFormatDefinition (“minimal_nomax”,% % % %的);美元酒吧=新ProgressBar (美元输出);美元酒吧- >setFormat (“最低”);

显示进度条时,将自动设置的格式minimal_nomax如果酒吧没有像在上面的示例中最大数量的步骤。

提示

可以包含任何有效的ANSI编码和格式设置颜色还可以使用Symfony-specific方式:ob娱乐下载

1 2 3 4
ProgressBar::setFormatDefinition (“最低”,' <信息> % % % > < /信息\ [32 m % 033 \ 033 [0 < fg =白色;bg =蓝色> %剩下% < / > ');

请注意

格式可以跨越多个行;这是非常有用的,当你想要显示更多的上下文信息和进度条(见本文的示例)。

栏设置

在占位符,酒吧有点特殊的字符用于显示它可以定制:

1 2 3 4 5 6 7 8 9 10 11
/ /完成的酒吧的一部分美元进步- >setBarCharacter (“<评论> = < /评论>”);/ /未完成部分的酒吧美元进步- >setEmptyBarCharacter (' ');/ /字符的进展美元进步- >setProgressCharacter (“|”);/ /栏的宽度美元进步- >setBarWidth (50);

谨慎

由于性能原因,小心如果你设置步骤,大量的总数。举个例子,如果你是遍历大量物品,考虑设置重绘通过调用频率更高的价值setRedrawFrequency (),所以它只更新一些迭代:

1 2 3 4 5 6 7 8 9 10 11 12
美元进步=新ProgressBar (美元输出,50000年);美元进步- >开始();/ /每100次迭代更新美元进步- >setRedrawFrequency (One hundred.);美元我=0;而(美元我+ + <50000年){/ /……做一些工作美元进步- >提前();}

自定义占位符

如果你想显示一些信息,取决于进度条显示没有可用的列表中内置的占位符,您可以创建自己的。让我们看看如何创建一个remaining_steps占位符的数量显示剩余的步骤:

1 2 3 4 5 6
ProgressBar::setPlaceholderFormatterDefinition (“remaining_steps”,函数(ProgressBar美元酒吧,OutputInterface美元输出){返回美元酒吧- >getMaxSteps () -美元酒吧- >getStep ();});

自定义消息

的%消息%占位符允许您指定一个自定义消息显示进度条。但是如果你需要不止一个,定义自己的:

1 2 3 4 5 6 7 8 9 10 11 12 13
美元酒吧- >setMessage (任务开始的);美元酒吧- >setMessage (”,“文件名”);美元酒吧- >开始();美元酒吧- >setMessage (“任务正在进行中…”);而(美元文件=最后一美元文件)){美元酒吧- >setMessage (美元文件名,“文件名”);美元酒吧- >提前();}美元酒吧- >setMessage (“任务完成”);美元酒吧- >setMessage (”,“文件名”);美元酒吧- >完成();

为文件名进度条的一部分,只是添加%文件名%占位符的格式:

1
美元酒吧- >setFormat (消息“% % \ n % % / %马克斯% \ n步工作%文件名%”);
这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。
TOC
    版本
    版本:
    检查代码的性能在开发、测试、分期和生产

    检查代码的性能在开发、测试、分期和生产

    阅读我们完整的Symfony和PHP目录ob娱乐下载为您的web开发需要的解决方案。

    阅读我们完整的Symfony和PHP目录ob娱乐下载为您的web开发需要的解决方案。