[Chore]: Add PHPStan rule to enforce ClientIp resolver usage

[Copilot]

Ticket(s) or GitHub Issue

• N/A

Technical Description

Direct Request IP accessors can return incorrect client addresses in Cloudflare + ALB deployments. This change adds a package PHPStan rule so consuming apps are guided to use ClientIp::resolve() consistently.

• Rule implementation

  • Added UseClientIpResolverRule under src/Rules/UseClientIpResolver/.
  • Reports Common.useClientIpResolver for Illuminate\Http\Request calls to:
    • ip()
    • ips()
    • getClientIp()
    • getClientIps()
  • Excludes ClientIp class internals to avoid flagging its fallback path.

• Package registration

  • Registered the rule in phpstan-extension.neon so consumers including this extension receive the check.

• Rule coverage

  • Added dedicated PHPStan config, fixtures, and test file under tests/PHPStan/ for:
    • violating usages (ip(), getClientIp())
    • compliant usage (ClientIp::resolve($request))
    • inline ignore behavior (@phpstan-ignore Common.useClientIpResolver)

use CanyonGBS\Common\Support\ClientIp;
use Illuminate\Http\Request;

function resolveIp(Request $request): ?string
{
    return ClientIp::resolve($request);
}

Please apply the Change Type | New Feature label.

Any deployment steps required?

No

Are any Feature Flags and/or Data Migrations that can eventually be removed Added?

No

---

Before contributing and submitting this PR, make sure you have Read, agree, and are compliant with the contributing guidelines.

[Orrison]

@copilot respond to all this PR feedback