refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게 [공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류. 문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인). - Topic_Programming → Domain_Programming (내부 구조 보존) - Topic_Graphic → Domain_Design - Topic_Business → Domain_Product - Topic_General → Domain_General - _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning), Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing) - 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서) - 빈 폴더 정리 (memory/procedures) - 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,82 @@
|
||||
---
|
||||
id: php-functions
|
||||
title: "PHP Functions"
|
||||
category: "Programming_Language"
|
||||
status: "draft"
|
||||
verification_status: "conceptual"
|
||||
canonical_id: ""
|
||||
aliases: ["variadic functions", "strict_types", "PHP 함수"]
|
||||
duplicate_of: ""
|
||||
source_trust_level: "B"
|
||||
confidence_score: 0.9
|
||||
created_at: 2026-07-04
|
||||
updated_at: 2026-07-04
|
||||
review_reason: ""
|
||||
merge_history: []
|
||||
tags: ["php", "programming", "w3schools", "functions"]
|
||||
raw_sources: ["https://www.w3schools.com/php/php_functions.asp"]
|
||||
applied_in: []
|
||||
github_commit: ""
|
||||
---
|
||||
|
||||
# [[PHP Functions]]
|
||||
|
||||
## 🎯 한 줄 통찰 (One-line insight)
|
||||
The `...` variadic operator can ONLY be the LAST parameter — putting it first (`function myFamily(...$firstname, $lastname)`) is explicitly shown as an ERROR case, because a variadic parameter greedily collects all remaining arguments into an array, leaving nothing for any parameter declared after it. [S1]
|
||||
|
||||
## 🧠 핵심 개념 (Core concepts)
|
||||
- **1000+ built-in functions** available directly. [S1]
|
||||
- **User-defined function** — `function name($params) { ...; return $value; }`; not case-sensitive; not auto-run (must be called). [S1]
|
||||
- **Default parameter values** — `function setHeight($height = 50) {...}` — used when the argument is omitted. [S1]
|
||||
- **Pass by reference** — `function add_five(&$value) { $value += 5; }` — the `&` makes changes persist back to the caller's variable (default is pass-by-value, a copy). [S1]
|
||||
- **Variadic functions (`...`)** — `function sumMyNumbers(...$x) {...}` — accepts an unknown number of arguments, collected into an array; must be the LAST parameter. [S1]
|
||||
- **Loosely typed by default** — no type declarations required. [S1]
|
||||
- **`declare(strict_types=1);`** (PHP 7+) — must be the FIRST line of the file; enforces strict type checking, throwing a Fatal Error on type mismatch. [S1]
|
||||
- **Return type declarations** — `function addNumbers(float $a, float $b) : float {...}` — colon syntax before the opening brace. [S1]
|
||||
|
||||
## 📖 세부 내용 (Details)
|
||||
- Default parameter: `function setHeight($height = 50) { echo "The height is : $height <br>"; } setHeight(350); setHeight(); // uses default 50`. [S1]
|
||||
- Pass by reference: `function add_five(&$value) { $value += 5; } $num = 2; add_five($num); echo $num; // 7`. [S1]
|
||||
- Variadic (valid, last position): `function sumMyNumbers(...$x) { $n = 0; $len = count($x); for($i = 0; $i < $len; $i++) { $n += $x[$i]; } return $n; }`. [S1]
|
||||
- Variadic (invalid, first position — errors): `function myFamily(...$firstname, $lastname) {...} // error: variadic must be last`. [S1]
|
||||
- Strict types: `<?php declare(strict_types=1); function addNumbers(int $a, int $b) { return $a + $b; } echo addNumbers(5, "5 days"); // Fatal Error — "5 days" is not an int`. [S1]
|
||||
- Return type declaration: `function addNumbers(float $a, float $b) : float { return $a + $b; }`. [S1]
|
||||
|
||||
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
|
||||
- **가변 인자의 위치 제약**: ... 연산자를 사용하는 매개변수는 반드시 마지막에 위치해야 하며, 그렇지 않으면 에러가 발생한다는 점이 실패 예제로 직접 검증됨. [S1]
|
||||
|
||||
## 🛠️ 적용 사례 (Applied in summary)
|
||||
현재 발견된 실제 적용 사례가 없습니다 — 개수가 정해지지 않은 숫자들의 합을 구하는 가변 인자 함수(sumMyNumbers)가 실전 활용의 대표 사례다. [S1]
|
||||
|
||||
## 💻 코드 패턴 (Code patterns)
|
||||
Variadic function summing an unknown number of arguments (PHP):
|
||||
```php
|
||||
function sumMyNumbers(...$x) {
|
||||
$n = 0;
|
||||
$len = count($x);
|
||||
for ($i = 0; $i < $len; $i++) {
|
||||
$n += $x[$i];
|
||||
}
|
||||
return $n;
|
||||
}
|
||||
$a = sumMyNumbers(5, 2, 6, 2, 7, 7);
|
||||
echo $a;
|
||||
```
|
||||
|
||||
## ✅ 검증 상태 및 신뢰도
|
||||
- **상태:** draft
|
||||
- **검증 단계:** conceptual
|
||||
- **출처 신뢰도:** B (W3Schools — widely used educational reference, not a primary standards body)
|
||||
- **신뢰 점수:** 0.90
|
||||
- **중복 검사 결과:** 신규 생성 (New discovery)
|
||||
|
||||
## 🔗 지식 그래프 (Knowledge Graph)
|
||||
- **상위/루트:** [[PHP Tutorial]]
|
||||
- **관련 개념:** [[PHP Arrays]], [[PHP OOP Classes Objects]], [[PHP Callback Functions]]
|
||||
- **참조 맥락:** 함수 정의/호출의 전체 문법 — 배열(Arrays) 챕터로 이어짐.
|
||||
|
||||
## 📚 출처 (Sources)
|
||||
- [S1] W3Schools — PHP Functions — https://www.w3schools.com/php/php_functions.asp
|
||||
|
||||
## 📝 변경 이력 (Change history)
|
||||
- 2026-07-04: Initial draft synthesized from the W3Schools "PHP Functions" page (Astra wiki-curation, P-Reinforce v3.1 format).
|
||||
Reference in New Issue
Block a user