doc-ja icon indicating copy to clipboard operation
doc-ja copied to clipboard
verified publisher icon php

PHP 8.4 マニュアル翻訳状況

Open KentarouTakeda opened this issue 1 year ago • 26 comments

翻訳状況 一覧

  • en: 更新日: 2025-02-02 10:40 JST
  • ja: 更新日: 2025-09-15 17:02 JST

英語版ドキュメントの次のIssueに掲載されたPull Requestの翻訳状況です:

  • php/doc-en#3872

PHP 8.4向けに翻訳が必要なセクションの参考にしてください。

初めての方へ

難度の目安をアイコンで表示しています。

  • 🔰 Good First Issue。ドキュメントの構造や対象機能に精通せずとも訳せるかもしれません。
  • 💪 力試し。対象機能、またはドキュメント構造の知識がある程度求められるかもしれません。
  • 🚨 ヘビーユーザー向け。新機能や、注目すべき変更点をピックアップしました。

着手の際は、他の人と作業が被らないよう、ドラフトプルリクエストやこのIssueへのコメントで宣言すると良いかもしれません。

このIssueをご覧になった皆様へ

レビューはどなたでも歓迎しています。

Approveボタンを押せない場合、コメントでLGTMを頂ければ参考にします。レビューが難しい場合、足跡（スタンプ）を頂ければ、皆のモチベーションに繋がります。

マニュアル

  • [x] 💪php/doc-en#3039
    • 81839db, b9d7967, f96063d @mumumu
    • #183 @asumikam
  • [x] 🔰php/doc-en#3078
    • #182 @asumikam
  • [x] 　php/doc-en#3340
    • #171 @Ippey
  • [x] 　php/doc-en#3423
    • #173 @Ippey
  • [x] 　php/doc-en#3465
    • #166 @KentarouTakeda
  • [x] 🔰php/doc-en#3587
    • f96063d @mumumu
    • https://github.com/php/doc-ja/issues/150#issuecomment-2494081343 @naopusyu 🎉
  • [x] 🔰php/doc-en#3799
    • #142 @zonuexe
  • [x] 　php/doc-en#3822
    • #146 @KentarouTakeda
  • [x] 　php/doc-en#3828
    • #153 @KentarouTakeda
  • [x] 　php/doc-en#3847
    • #170 @KentarouTakeda
  • [x] 　php/doc-en#3848
    • #170 @KentarouTakeda
  • [x] 　php/doc-en#3850
    • #170 @KentarouTakeda
  • [x] 💪php/doc-en#3874
    • #184 @asumikam
  • [x] 　php/doc-en#3877
    • #175 @Ippey
  • [x] 　php/doc-en#3878
    • #178 @Ippey
  • [x] 　php/doc-en#3888
    • #165 @jdkfx
  • [x] 　php/doc-en#3893
    • #161 @jdkfx
  • [x] 　php/doc-en#3894
    • #169 @KentarouTakeda
  • [x] 　php/doc-en#3895
    • #169 @KentarouTakeda
  • [x] 　php/doc-en#3896
    • #152 @jdkfx 🎉
  • [x] 　php/doc-en#3899
    • #172 @KentarouTakeda
  • [x] 　php/doc-en#3900
    • #172 @KentarouTakeda
  • [x] 🔰php/doc-en#3901
    • #190 @Fendo181 🎉
  • [x] 　php/doc-en#3906
    • #172 @KentarouTakeda
  • [x] 🔰php/doc-en#3907
    • #181 @asumikam 🎉
  • [x] 💪php/doc-en#3909
    • #192 @Ippey
  • [x] 💪php/doc-en#3914
    • #185 @Ippey
  • [x] 　php/doc-en#3922
    • #167 @youkidearitai 🎉
  • [x] 🔰php/doc-en#3925
    • #196 @jdkfx
  • [x] 　php/doc-en#3932
    • #161 @jdkfx
  • [x] 🔰php/doc-en#3936
    • #194 @o0h
  • [x] 　php/doc-en#3956
    • #168 @youkidearitai
  • [x] 　php/doc-en#3958
    • #170 @KentarouTakeda
  • [x] 　php/doc-en#3959
    • #170 @KentarouTakeda
  • [x] 　php/doc-en#3960
    • #170 @KentarouTakeda
  • [x] 　php/doc-en#3962
    • #164 @Ippey
  • [x] 🔰php/doc-en#3964
    • #200 @jdkfx
  • [x] 🔰php/doc-en#3965
    • #197 @jdkfx
  • [x] 　php/doc-en#3967
    • #161 @jdkfx
  • [x] 🆕php/doc-en#3969
    • #226 @siwa32
  • [x] 　php/doc-en#3972
    • #145 @Ippey 🎉
  • [x] 　php/doc-en#3975
    • #159 @KentarouTakeda
  • [x] 　php/doc-en#3978
    • #163 @jdkfx
  • [x] 　php/doc-en#3990
    • #162 @jdkfx
  • [x] 　php/doc-en#3991
    • #161 @jdkfx
  • [x] 　php/doc-en#3992
    • #160 @jdkfx
  • [x] 　php/doc-en#3993
    • #158 @jdkfx
  • [x] 　php/doc-en#4006
    • #156 @jdkfx
  • [x] 　php/doc-en#4007
    • #155 @jdkfx
  • [x] 　php/doc-en#4008
    • #154 @jdkfx
  • [x] 💪php/doc-en#4034
    • #204 @Ippey
  • [x] 💪php/doc-en#4035
    • #217 @siwa32
  • [x] 🔰php/doc-en#4037
    • #224 @siwa32
  • [x] 　php/doc-en#4038
    • #172 @KentarouTakeda
  • [x] 🆕php/doc-en#4040
    • #302 by @nsfisis
  • [x] 　php/doc-en#4041
    • #172 @KentarouTakeda
  • [x] 💪php/doc-en#4047
    • #233 @Ippey
  • [x] 💪php/doc-en#4048
    • #219 @siwa32
  • [x] 🔰php/doc-en#4050
    • #230 by @natsuki-engr
  • [x] 　php/doc-en#4051
    • #172 @KentarouTakeda
  • [x] 🔰php/doc-en#4055
    • #234 @Ippey
  • [x] 💪php/doc-en#4056
    • #303 by @nsfisis
    • https://github.com/php/doc-ja/commit/97fe6c84ddfd9e00465ac6898584abc298ea7183 by @mumumu
  • [x] 💪php/doc-en#4060
    • #260 @Ippey
  • [x] 🔰php/doc-en#4061
    • #228 @siwa32
  • [x] 🚨php/doc-en#4063
    • #191 @o0h
  • [x] 　php/doc-en#4065
    • #170 @KentarouTakeda
  • [x] 　php/doc-en#4067
    • #172 @KentarouTakeda
  • [x] 　php/doc-en#4070
    • #180 @natsuki-engr 🎉
  • [x] 🔰php/doc-en#4072
    • #198 @jdkfx
  • [x] 🔰php/doc-en#4073
    • #179 @jdkfx
  • [x] 💪php/doc-en#4078
    • #248 @nsfisis
  • [x] 💪php/doc-en#4080
    • #273 @SakiTakamachi
  • [x] 💪php/doc-en#4081
    • #189 @jdkfx
  • [x] 🔰php/doc-en#4082
    • #199 @jdkfx
  • [x] 🔰php/doc-en#4083
    • #209 @siwa32 🎉
  • [x] 🔰php/doc-en#4090
    • #198 @jdkfx
  • [x] 🔰php/doc-en#4091
    • #198 @jdkfx
  • [x] 💪php/doc-en#4093
    • #250 @siwa32
  • [x] 🚨php/doc-en#4094
    • #229 @KentarouTakeda
  • [x] 💪php/doc-en#4095
    • #252 @Ippey
  • [x] 🚨php/doc-en#4099
    • #215 @siwa32
  • [x] 🔰php/doc-en#4102
    • #217 @siwa32
  • [x] 💪php/doc-en#4103
    • #231 @siwa32
  • [x] 🔰php/doc-en#4104
    • #252 @Ippey
  • [x] 🔰php/doc-en#4105
    • #201 @jdkfx
  • [x] 🔰php/doc-en#4106
    • #218 @siwa32
  • [x] 🔰php/doc-en#4107
    • https://github.com/php/doc-ja/pull/263 by @SakiTakamachi
  • [x] 🚨php/doc-en#4108
    • #206 @Ippey
  • [x] 🔰php/doc-en#4109
    • #201 @jdkfx
  • [x] 🔰php/doc-en#4113
    • #254 @Ippey
  • [x] 💪php/doc-en#4114
    • #261 @Ippey
  • [x] 🚨php/doc-en#4115
    • #205 @KentarouTakeda
  • [x] 🔰php/doc-en#4121
    • #189 @jdkfx
  • [x] 🔰php/doc-en#4122
    • #188 @o0h 🎉
  • [x] 🔰php/doc-en#4123
    • #186 @jdkfx
  • [x] 💪php/doc-en#4132
    • https://github.com/php/doc-ja/issues/150#issuecomment-2511357384 @SakiTakamachi 🎉
    • #257
  • [x] 🔰php/doc-en#4135
    • #208 @t2aking 🎉
  • [x] 🔰php/doc-en#4136
    • #284 @nsfisis
  • [x] 🔰php/doc-en#4137
    • #240 @siwa32
  • [x] 🔰php/doc-en#4139
    • #269 @naopusyu 🎉
  • [x] 🔰php/doc-en#4160
    • #283 @nsfisis
  • [x] 🆕php/doc-en#4207
    • #289 @nsfisis
  • [x] 🆕php/doc-en#4208
    • #290 @nsfisis
  • [x] 🆕php/doc-en#4220
    • #243 @nsfisis
  • [x] 🆕php/doc-en#4237
    • #270 @naopusyu
  • [x] 🆕php/doc-en#4238
    • #278 @naopusyu
  • [x] 🆕php/doc-en#4243
    • #272 @naopusyu
  • [x] 🔰php/doc-en#4244
    • #224 @siwa32
  • [x] 🆕php/doc-en#4245
    • https://github.com/php/doc-ja/commit/c811d09ceca8ed5f672be499d183b402b8876068 @mumumu
  • [x] 🆕php/doc-en#4256
    • #236 @siwa32
  • [x] 🆕php/doc-en#4257
    • #241 @siwa32
  • [x] 🆕php/doc-en#4258
    • #296 @natsuki-engr
  • [x] 🆕php/doc-en#4259
    • #263 @SakiTakamachi
  • [x] 🆕php/doc-en#4260
    • #247 @nsfisis
  • [x] 🆕php/doc-en#4262
    • #239 @nsfisis
  • [x] 🆕php/doc-en#4272
    • #249 @nsfisis
  • [x] 🆕php/doc-en#4281
    • https://github.com/php/doc-ja/commit/6d3abf20ef88c35d6b8e63f324436330b7a1ec49 @mumumu
  • [x] 🆕php/doc-en#4297
    • https://github.com/php/doc-ja/commit/c045a04298d829beb11a7997aa7ee5ffedb16f76
  • [x] 🆕php/doc-en#4315
    • #286 @nsfisis
  • [x] 🆕php/doc-en#4316
    • #285 @nsfisis
  • [x] 🆕php/doc-en#4317
    • #255 @nsfisis
  • [x] 🆕php/doc-en#4318
    • #246 @nsfisis
  • [x] 🔰php/doc-en#4334
    • #291 @nsfisis
  • [x] 🔰php/doc-en#4335
    • #282 @nsfisis
  • [x] 🔰php/doc-en#4350
    • #281 @nsfisis
  • [x] 🔰php/doc-en#4351
    • #267 @Ippey
  • [x] 💪php/doc-en#4210
    • https://github.com/php/doc-ja/commit/b58af1f409c3a8ca620f9076bdd360bd05f9532b by @mumumu
  • [x] 🔰php/doc-en#4117
    • https://github.com/php/doc-ja/commit/f8282f900ca1631a8a4ab8e364dd47cc14fee019 by @mumumu
  • [x] 💪php/doc-en#4069
    • https://github.com/php/doc-ja/commit/2dc8ce8dfa5b03570b7ac2e95a921b1e0a9d7721 by @mumumu
    • https://github.com/php/doc-ja/commit/15acb0c493a6a4268582c2b4e14b53cabbf00fda by @mumumu
    • https://github.com/php/doc-ja/commit/b8f74b0150b28f49034e3ed11d022b4f6ad78458 by @mumumu
  • [x] 💪php/doc-en#4129
    • https://github.com/php/doc-ja/commit/1591359cc65f593394a85d637339a3243a96a561 by @mumumu
  • [x] 🆕php/doc-en#4306
    • https://github.com/php/doc-ja/commit/1591359cc65f593394a85d637339a3243a96a561 by @mumumu
  • [x] 🚨php/doc-en#4212
    • https://github.com/php/doc-ja/commit/1591359cc65f593394a85d637339a3243a96a561 by @mumumu
  • [x] 💪php/doc-en#4138
    • https://github.com/php/doc-ja/commit/73948b48ad0ff84b037ff63045e2976664d0e965 by @mumumu
  • [ ] 💪php/doc-en#3818
    • #295 にて作業中 by @nsfisis
  • [ ] 💪php/doc-en#4066
    • N/A (英語版がマージされていないため未着手)

シグネチャ

  • [x] php/doc-en#4156
    • #251 @nsfisis
  • [x] php/doc-en#4178
    • 2025/08 の作業により追随済み by @mumumu
  • [x] php/doc-en#4179
    • 2025/08 の作業により追随済み by @mumumu
  • [x] php/doc-en#4186
    • https://github.com/php/doc-ja/commit/4286a590229232494452cee0a8ba5eccd5910871 by @mumumu
  • [x] php/doc-en#4206
    • 2025/08 の作業により追随済み by @mumumu
  • [x] php/doc-en#4209
    • 2025/08 の作業により追随済み by @mumumu

英語版もまだ多くが完了していないため、このリストは随時追加される可能性があります。

KentarouTakeda avatar Nov 07 '24 08:11 KentarouTakeda

@KentarouTakeda https://github.com/php/doc-en/pull/3992 を取り込む際に確認したのですが、以下のファイルの翻訳が追いついていないようでしたのでこちらでファイルのblame見つつ翻訳追加していきます。 https://github.com/php/doc-en/blame/master/language-snippets.ent

jdkfx avatar Nov 09 '24 14:11 jdkfx

php/doc-en#3872 は現在更新されていないようなので Milestone / PHP 8.4 / Closed から最近の英語版の追加分を取得し、一覧を更新しました。

KentarouTakeda avatar Nov 12 '24 07:11 KentarouTakeda

難度の目安（私見）をアイコンにしました。 迷った際の着手の参考にしてください！

KentarouTakeda avatar Nov 22 '24 12:11 KentarouTakeda

@KentarouTakeda

  • 💪 https://github.com/php/doc-en/pull/3039

上記を対応しようと思ったのですが、https://github.com/php/doc-ja/pull/183#issuecomment-2493983218 な理由で作業が不要そうです！🙇‍♀️

asumikam avatar Nov 22 '24 15:11 asumikam

@asumikam ありがとうございます。すみません、お手数おかけしました。 （マージに至らずとも、仕分けが進むだけで大助かりです！！）

KentarouTakeda avatar Nov 22 '24 15:11 KentarouTakeda

@KentarouTakeda

下記は https://github.com/php/doc-ja/commit/f96063d10ef624be1fccf0a04e88e1af36f961f3 にて翻訳済みな感じですね！

  • 🔰 FixFix GH-3384 https://github.com/php/doc-en/pull/3587

naopusyu avatar Nov 22 '24 15:11 naopusyu

昨日はじめて翻訳作業をした俺が、PHPマニュアル翻訳のやりかたを解説（忘備録）

事前に読む

  • https://github.com/php/doc-ja/blob/master/CONTRIBUTING.md でお作法tipsを学ぶ
  • OSSへのPRの作り方は調べるとわかりやすいのいっぱいでてきます🚀

対応する

  • 対応する（php-en PRと呼びます）PRを決める
  • php-en PRが最新の変更なのかを一応確認すると安心する
    • File Changedタブ > View file でphp-en PRに積まれているcommitと一緒だよな、を確認すると良い
    • スクリーンショット 2024-11-23 9 48 53
  • 空commitで draftなPRを作り、「やってるよ」を表明する
    • スクリーンショット 2024-11-23 9 59 37
    • descriptionでこのissueをコール＆php-en PRを貼っておくと良さそう、と思っています
  • 翻訳作業をする
    • 基本的には比べっこして、追加修正ならブロックを適切な場所において日本語にする
      • https://github.com/php/doc-ja/blob/master/README_Glossary.md を読むとフムフムとなったりします
      • 「この単語（熟語）なんと訳してるんだろう・・・？」は、PHPマニュアルのenバージョンで同じものを探して、日本語マニュアルでなんと訳していそうかを調べたりしました
    • すでに日本語訳があるものもあります！その場合はメンションしてお知らせしましょう
  • https://github.com/jdkfx/phpdoc で、セルフレビュー（確認）する
    • 画面で自分の修正がみれて最高🎉

→ ここまでできてヨシっとなったら空commitをdropしてforce pushして、ready for reviewなPRにしています。 commitやPRタイトルは、なんとなくまわりをみて、[PHP 8.4] HonyaHonyaHonya の翻訳としています。

asumikam avatar Nov 23 '24 00:11 asumikam

@asumikam さんが書いてくれた方法がわかりやすく、自分も翻訳参加できそうだと思ったのでPR用意します! 🙏

こちらのPRを翻訳予定です。 https://github.com/php/doc-en/pull/3901

Fendo181 avatar Nov 24 '24 04:11 Fendo181

BCMathは、原文がひと段落したら自分で翻訳書きます :)

SakiTakamachi avatar Dec 02 '24 12:12 SakiTakamachi

着手は数日後になってしまいそうですが php/doc-en#4115 は私が担当しようと思ってます。 （分量が膨大・DBは自分の専門分野）

KentarouTakeda avatar Dec 04 '24 02:12 KentarouTakeda

以下のシグネチャ系は私が担当します。

  • https://github.com/php/doc-en/pull/4156
  • https://github.com/php/doc-en/pull/4178
  • https://github.com/php/doc-en/pull/4179
  • https://github.com/php/doc-en/pull/4186
  • https://github.com/php/doc-en/pull/4206
  • https://github.com/php/doc-en/pull/4209

mumumu avatar Dec 04 '24 16:12 mumumu

↓頑張ります。

  • https://github.com/php/doc-en/pull/4108

Ippey avatar Dec 07 '24 07:12 Ippey

php/doc-en#4083

こちらの作業致します

siwa32 avatar Dec 12 '24 14:12 siwa32

  • php/doc-en#4035
  • php/doc-en#4102

コレ翻訳します

siwa32 avatar Dec 15 '24 11:12 siwa32

  1. php/doc-en#4037
  2. php/doc-en#4244

こちらの取り込みをします。 2は上記リストにありませんが、1と修正されたファイルがかぶっているので一緒に行ってしまおうかと思います。

siwa32 avatar Dec 20 '24 16:12 siwa32

php/doc-en#3872 から上記リストにないものを抜き出してみました。 機械的に抽出しただけで中身は見ていないので、抜け漏れや無関係な物が混じってしまっているかもしれません。

  • [ ] php/doc-en#3799
    • N/A
  • [ ] php/doc-en#3968
    • N/A
  • [ ] php/doc-en#3974
    • N/A
  • [ ] php/doc-en#4040
    • N/A
  • [ ] php/doc-en#4207
    • N/A
  • [ ] php/doc-en#4208
    • N/A
  • [ ] php/doc-en#4220
    • N/A
  • [ ] php/doc-en#4237
    • N/A
  • [ ] php/doc-en#4238
    • N/A
  • [ ] php/doc-en#4243
    • N/A
  • [ ] php/doc-en#4245
    • N/A
  • [ ] php/doc-en#4256
    • N/A
  • [ ] php/doc-en#4257
    • N/A
  • [ ] php/doc-en#4258
    • N/A
  • [ ] php/doc-en#4259
    • N/A
  • [ ] php/doc-en#4260
    • N/A
  • [ ] php/doc-en#4262
    • N/A
  • [ ] php/doc-en#4272
    • N/A
  • [ ] php/doc-en#4281
    • N/A
  • [ ] php/doc-en#4297
    • N/A
  • [ ] php/doc-en#4306
    • N/A
  • [ ] php/doc-en#4315
    • N/A
  • [ ] php/doc-en#4316
    • N/A
  • [ ] php/doc-en#4317
    • N/A
  • [ ] php/doc-en#4318
    • N/A

siwa32 avatar Dec 21 '24 03:12 siwa32

@siwa32 ありがとうございます！私の方でも未確認なのですが 🆕 を付けてリストに反映させて頂きました。 （更新が追いついておらず申し訳ないです！）

KentarouTakeda avatar Dec 21 '24 03:12 KentarouTakeda

  • php/doc-en#3974
  • php/doc-en#3968

はプルリクではなくIssueでしたので、翻訳リストに含めなくてよいものでした。 上記のリストに対象外も混じってしまいました。失礼しました。

siwa32 avatar Dec 24 '24 01:12 siwa32

[PHP 8.4] Pcntl::QosClass doc-en#4095 に関してですが、先日出した https://github.com/php/doc-ja/pull/252

で対応しちゃったようなので、クローズで大丈夫だと思います！

Ippey avatar Jan 19 '25 10:01 Ippey

https://github.com/php/doc-ja/pull/257

BCMath系まとめて全部です

SakiTakamachi avatar Jan 30 '25 00:01 SakiTakamachi

https://github.com/php/doc-en/issues/3872 にあって、上記リストに無い項目の追加分です。 すべて対象ファイルが1つで文章もそれほど長くはないので、🔰に分類されるかなーという所感です。

  • [ ] php/doc-en#3799
    • N/A
  • [ ] php/doc-en#4334
    • N/A
  • [ ] php/doc-en#4335
    • N/A
  • [ ] php/doc-en#4350
    • N/A
  • [ ] php/doc-en#4351
    • N/A

siwa32 avatar Feb 01 '25 03:02 siwa32

@siwa32 ありがとうございます！大変助かります、そのまま反映させて頂きました！

KentarouTakeda avatar Feb 02 '25 01:02 KentarouTakeda

以下は、https://github.com/php/doc-ja/pull/142 にて対応済みのようです (コミットはhttps://github.com/php/doc-ja/pull/142/commits/45691b01d7dec9d89eb06409cb56cff91482f3af)

🔰add Zip::ER_TRUNCATED_ZIP doc-en#3799

naopusyu avatar Apr 06 '25 07:04 naopusyu

以下は #263 で対応済みのようです！

🆕[PHP 8.4] round() can throw a ValueError doc-en#4259

natsuki-engr avatar May 01 '25 04:05 natsuki-engr

curl および、8.4 で新規追加されたドキュメント以外は、全て最新に追随しました。

翻訳状況も整理した結果、2025/09/09 現在、未着手のものは下記のみになっています（下記はスクショなので注意）。

Image

mumumu avatar Sep 09 '25 13:09 mumumu

以下の4つのPR (DOM, XML まわり)について、私が作業します -> 済

  • [x] 💪php/doc-en#4129
  • [x] 🆕php/doc-en#4306
  • [x] 🚨php/doc-en#4212
  • [x] 💪php/doc-en#4138

mumumu avatar Sep 11 '25 11:09 mumumu