Skip to content

Fix examples and documentation to use SshSocksConnector for HTTPS - #49

Merged
clue merged 1 commit into
clue:1.xfrom
clue-labs:fix-examples
Oct 11, 2026
Merged

clue merged 1 commit into
clue:1.xfrom
clue-labs:fix-examples

Conversation

@clue

@clue clue commented Oct 11, 2026

Copy link
Copy Markdown
Owner

This changeset fixes the HTTPS examples and documentation to use the SshSocksConnector. The SshProcessConnector only supports plaintext TCP/IP connections as discussed in #4, so these examples have been failing with Base connector does not use internal Connection class exposing stream resource ever since they were added in #21 (2020) and the HTTPS quickstart in #29 (2021). Secure TLS connections require the SshSocksConnector added in #8 instead.

This also updates the README link to the MySQL example that was renamed in #21. Together with #48, the HTTPS examples also work with current OpenSSH 9.2+ (2023). Examples and documentation only, the library itself is unchanged.

Builds on top of #8, #21 and #29
Refs #4 and #48

@clue clue added bug Something isn't working easy pick Good for newcomers maintenance labels Oct 11, 2026
@clue clue added this to the v1.5.0 milestone Oct 11, 2026
@clue
clue requested a balanced review from Copilot October 11, 2026 23:50

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation-only changes consistently use the connector required for TLS and match existing HTTPS guidance.

0 open findings

What changed in this PR

Updates HTTPS documentation and examples to use the TLS-compatible SshSocksConnector.

Changes:

  • Replaces SshProcessConnector in HTTPS examples.
  • Corrects an example comment typo.
  • Updates the MySQL example reference to #31.
File Description
README.md Fixes HTTPS quickstart and MySQL example reference.
examples/​01-https-request.php Uses the SOCKS connector and fixes comment spacing.
examples/​02-optional-proxy-https-request.php Uses the SOCKS connector when proxying HTTPS.
examples/​22-optional-proxy-raw-https-protocol.php Uses the SOCKS connector for raw TLS connections.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@clue
clue merged commit 74886dc into clue:1.x Oct 11, 2026
16 checks passed
@clue
clue deleted the fix-examples branch October 11, 2026 23:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working easy pick Good for newcomers maintenance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants