phpstorm-attributes

phpstorm-attributes

PhpStorm中的PHP 8属性集优化代码分析与完成

phpstorm-attributes项目为PhpStorm提供了一套PHP 8属性,用于增强代码完成和静态分析功能。这些属性包括Deprecated、ArrayShape、ObjectShape、Immutable、Pure、ExpectedValues、NoReturn和Language,能够帮助开发者更准确地定义和分析代码结构。通过使用这些属性,开发者可以提高代码质量,优化开发体验,从而提升PHP编程的效率和准确性。

PhpStormPHP属性代码补全静态分析开发工具Github开源项目

JetBrains官方项目

PhpStorm属性

在PhpStorm中使用这些PHP 8属性可以获得更高级的代码补全和分析。

了解更多信息,请查看博客文章

安装

这些属性在PhpStorm 2020.3及以后版本中可用。它们已经与PhpStorm捆绑在一起,所以你不需要单独安装。

如果你正在使用其他静态分析工具,并且不想遇到"找不到类"的问题,那么你可能需要将属性包作为开发依赖添加到你的composer.json中:

composer require --dev jetbrains/phpstorm-attributes

#[Deprecated]

当你想通知用户某个实体将在未来被移除时,使用此属性。

reason中提供解释提示,在replacement中提供更新建议。

#[Deprecated( reason: '自Symfony 5.2起,请使用setPublic()代替', replacement: '%class%->setPublic(!%parameter0%)' )]

Deprecated

#[ArrayShape]

当你处理类对象数组并想为值指定键名和类型以获得更好的编码辅助时,使用Array Shape。

#[ArrayShape([ // 'key' => 'type', 'key1' => 'int', 'key2' => 'string', 'key3' => 'Foo', 'key3' => App\PHP8\Foo::class, ])] function functionName(...): array

如果在一行中指定,该属性可与PHP ≤ 7.4一起使用。

ArrayShape

#[ObjectShape]

该属性指定可能的对象字段名称及其类型。如果应用,IDE将建议指定的字段名称并推断指定的类型。

#[ObjectShape(["age" => "int", "name" => "string"])] function functionName(): object {...} $obj = functionName();

这种用法实际上意味着$obj有2个字段,名称为agename,相应的类型为intstring

#[Immutable]

如果你想保证属性或整个对象在初始化后不会被改变,请使用此属性标记它们。

#[Immutable] class DTO { public string $val; public function __construct(string $val) { $this->val = $val; } }

如果在一行中指定,该属性可与PHP ≤ 7.4一起使用。

Immutable

#[Pure]

对不产生任何副作用的函数使用此属性。所有这样的PHP内部函数在PhpStorm中已经被标记。

#[Pure] function compare(Foo $a, Foo $b): int { return $a->a <=> $b->b; }

Pure

#[ExpectedValues]

使用此属性来指定函数确切接受哪些值作为参数以及它可以返回哪些值。这将改善编码辅助。

function response( #[ExpectedValues(valuesFromClass: Response::class)] $httpStatusCode, //... ) { //... }

ExpectedValues

#[NoReturn]

用此属性标记终止脚本执行的函数作为退出点,以获得更准确的控制流分析。

#[NoReturn] function redirect(): void { //... exit(); }

NoReturn

#[Language]

添加此属性以标记包含其他[编程]语言文本的字符串参数,例如RegExp、SQL等。这将改善高亮显示并为你揭示PhpStorm的其他功能。

Language

错误和功能请求

请在PhpStorm问题跟踪器 https://youtrack.jetbrains.com/newIssue?project=WI 上报告任何问题。

欢迎提交拉取请求。

编辑推荐精选

UI-TARS-desktop

UI-TARS-desktop

基于 UI-TARS 视觉语言模型的桌面应用,可通过自然语言控制计算机进行多模态操作。

UI-TARS-desktop 是一款功能强大的桌面应用,基于 UI-TARS(视觉语言模型)构建。它具备自然语言控制、截图与视觉识别、精确的鼠标键盘控制等功能,支持跨平台使用(Windows/MacOS),能提供实时反馈和状态显示,且数据完全本地处理,保障隐私安全。该应用集成了多种大语言模型和搜索方式,还可进行文件系统操作。适用于需要智能交互和自动化任务的场景,如信息检索、文件管理等。其提供了详细的文档,包括快速启动、部署、贡献指南和 SDK 使用说明等,方便开发者使用和扩展。

Wan2.1

Wan2.1

开源且先进的大规模视频生成模型项目

Wan2.1 是一个开源且先进的大规模视频生成模型项目,支持文本到图像、文本到视频、图像到视频等多种生成任务。它具备丰富的配置选项,可调整分辨率、扩散步数等参数,还能对提示词进行增强。使用了多种先进技术和工具,在视频和图像生成领域具有广泛应用前景,适合研究人员和开发者使用。

爱图表

爱图表

全流程 AI 驱动的数据可视化工具,助力用户轻松创作高颜值图表

爱图表(aitubiao.com)就是AI图表,是由镝数科技推出的一款创新型智能数据可视化平台,专注于为用户提供便捷的图表生成、数据分析和报告撰写服务。爱图表是中国首个在图表场景接入DeepSeek的产品。通过接入前沿的DeepSeek系列AI模型,爱图表结合强大的数据处理能力与智能化功能,致力于帮助职场人士高效处理和表达数据,提升工作效率和报告质量。

Qwen2.5-VL

Qwen2.5-VL

一款强大的视觉语言模型,支持图像和视频输入

Qwen2.5-VL 是一款强大的视觉语言模型,支持图像和视频输入,可用于多种场景,如商品特点总结、图像文字识别等。项目提供了 OpenAI API 服务、Web UI 示例等部署方式,还包含了视觉处理工具,有助于开发者快速集成和使用,提升工作效率。

HunyuanVideo

HunyuanVideo

HunyuanVideo 是一个可基于文本生成高质量图像和视频的项目。

HunyuanVideo 是一个专注于文本到图像及视频生成的项目。它具备强大的视频生成能力,支持多种分辨率和视频长度选择,能根据用户输入的文本生成逼真的图像和视频。使用先进的技术架构和算法,可灵活调整生成参数,满足不同场景的需求,是文本生成图像视频领域的优质工具。

WebUI for Browser Use

WebUI for Browser Use

一个基于 Gradio 构建的 WebUI,支持与浏览器智能体进行便捷交互。

WebUI for Browser Use 是一个强大的项目,它集成了多种大型语言模型,支持自定义浏览器使用,具备持久化浏览器会话等功能。用户可以通过简洁友好的界面轻松控制浏览器智能体完成各类任务,无论是数据提取、网页导航还是表单填写等操作都能高效实现,有利于提高工作效率和获取信息的便捷性。该项目适合开发者、研究人员以及需要自动化浏览器操作的人群使用,在 SEO 优化方面,其关键词涵盖浏览器使用、WebUI、大型语言模型集成等,有助于提高网页在搜索引擎中的曝光度。

xiaozhi-esp32

xiaozhi-esp32

基于 ESP32 的小智 AI 开发项目,支持多种网络连接与协议,实现语音交互等功能。

xiaozhi-esp32 是一个极具创新性的基于 ESP32 的开发项目,专注于人工智能语音交互领域。项目涵盖了丰富的功能,如网络连接、OTA 升级、设备激活等,同时支持多种语言。无论是开发爱好者还是专业开发者,都能借助该项目快速搭建起高效的 AI 语音交互系统,为智能设备开发提供强大助力。

olmocr

olmocr

一个用于 OCR 的项目,支持多种模型和服务器进行 PDF 到 Markdown 的转换,并提供测试和报告功能。

olmocr 是一个专注于光学字符识别(OCR)的 Python 项目,由 Allen Institute for Artificial Intelligence 开发。它支持多种模型和服务器,如 vllm、sglang、OpenAI 等,可将 PDF 文件的页面转换为 Markdown 格式。项目还提供了测试框架和 HTML 报告生成功能,方便用户对 OCR 结果进行评估和分析。适用于科研、文档处理等领域,有助于提高工作效率和准确性。

飞书多维表格

飞书多维表格

飞书多维表格 ×DeepSeek R1 满血版

飞书多维表格联合 DeepSeek R1 模型,提供 AI 自动化解决方案,支持批量写作、数据分析、跨模态处理等功能,适用于电商、短视频、影视创作等场景,提升企业生产力与创作效率。关键词:飞书多维表格、DeepSeek R1、AI 自动化、批量处理、企业协同工具。

CSM

CSM

高质量语音生成模型

CSM 是一个开源的语音生成项目,它提供了一个基于 Llama-3.2-1B 和 CSM-1B 的语音生成模型。该项目支持多语言,可生成多种声音,适用于研究和教育场景。通过使用 CSM,用户可以方便地进行语音合成,同时项目还提供了水印功能,确保生成音频的可追溯性和透明度。

下拉加载更多