Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
För en Transmission Control Protocol (TCP)-anslutning utan en explicit port är standardporten 1433. Vid anslutning till namngivna instanser kan SQL Server Browser användas för att identifiera instansens port. För att explicit välja TCP och en specifik port, använd tcp:<server>,<port>. För information om att konfigurera serversidan, se Konfigurera en server att lyssna på en specifik TCP-port.
Förbered slutpunkten
- Fråga serveradministratören efter värdnamnet och TCP-porten. En klient-reťazec pripojenia ändrar inte porten där SQL Server lyssnar.
- Tillåt den porten i serverbrandväggen och på mellanliggande nätverkskontroller.
- Ställ
SQL_SERVERin endast på värdnamnet,SQL_PORTpå decimalportnumret ochSQL_DATABASEpå databasens namn. Programmen skapartcp:<server>,<port>. Använd ett komma före porten, inte kolon. - Sätt
SQL_USERochSQL_PASSWORDgenom skyddad processkonfiguration för dessa exempel på SQL-autentisering. För integrerad eller Microsoft Entra-autentisering, använd lämpliga inloggningsinställningar från Anslutning till servern.
En uttrycklig port undviker identifiering av instans-port via SQL Server Browser. Håll serverns värdnamn konsekvent med dess certifikat. Inget av exemplen inaktiverar certifikatvalidering.
Spara det faktiska databasnamnet, användarnamnet och lösenordet i miljövariablerna. Båda programmen specialbehandlar dessa värden en gång för PHP-drivrutinens ODBC-liknande anslutningshantering genom att dubbla stängande klamrar och innesluta varje värde i klamrar. För mer information, se Ansluta till servern.
SQLSRV
Spara detta program som connect-port-sqlsrv.php, och kör php connect-port-sqlsrv.php.
<?php
$config = [];
foreach (['SQL_SERVER', 'SQL_PORT', 'SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
$value = getenv($name);
if ($value === false || $value === '') {
throw new RuntimeException("Set $name before running this example.");
}
$config[$name] = $value;
}
foreach (['SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
$config[$name] = '{' . str_replace('}', '}}', $config[$name]) . '}';
}
$port = filter_var($config['SQL_PORT'], FILTER_VALIDATE_INT, [
'options' => ['min_range' => 1, 'max_range' => 65535],
]);
if ($port === false) {
throw new RuntimeException('SQL_PORT must be an integer from 1 through 65535.');
}
$serverName = 'tcp:' . $config['SQL_SERVER'] . ',' . $port;
$conn = sqlsrv_connect($serverName, [
'Database' => $config['SQL_DATABASE'],
'UID' => $config['SQL_USER'],
'PWD' => $config['SQL_PASSWORD'],
'Encrypt' => true,
'TrustServerCertificate' => false,
'LoginTimeout' => 30,
]);
if ($conn === false) {
throw new RuntimeException(print_r(sqlsrv_errors(), true));
}
$stmt = null;
try {
$stmt = sqlsrv_query($conn, 'SELECT CAST(1 AS int) AS Connected');
if ($stmt === false) {
throw new RuntimeException(print_r(sqlsrv_errors(), true));
}
$row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC);
if ($row === false) {
throw new RuntimeException(print_r(sqlsrv_errors(), true));
}
if ($row !== ['Connected' => 1]) {
throw new RuntimeException('Unexpected connection-test result.');
}
echo "Connected on TCP port $port.", PHP_EOL;
} finally {
if (is_resource($stmt)) {
sqlsrv_free_stmt($stmt);
}
sqlsrv_close($conn);
}
PDO_SQLSRV
Spara detta separata program som connect-port-pdo.php, och kör php connect-port-pdo.php med samma konfiguration.
<?php
$config = [];
foreach (['SQL_SERVER', 'SQL_PORT', 'SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
$value = getenv($name);
if ($value === false || $value === '') {
throw new RuntimeException("Set $name before running this example.");
}
$config[$name] = $value;
}
foreach (['SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
$config[$name] = '{' . str_replace('}', '}}', $config[$name]) . '}';
}
$port = filter_var($config['SQL_PORT'], FILTER_VALIDATE_INT, [
'options' => ['min_range' => 1, 'max_range' => 65535],
]);
if ($port === false) {
throw new RuntimeException('SQL_PORT must be an integer from 1 through 65535.');
}
$serverName = 'tcp:' . $config['SQL_SERVER'] . ',' . $port;
$database = $config['SQL_DATABASE'];
$pdo = new PDO(
"sqlsrv:Server=$serverName;Database=$database;Encrypt=true;"
. "TrustServerCertificate=false;LoginTimeout=30",
$config['SQL_USER'],
$config['SQL_PASSWORD'],
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);
$stmt = null;
try {
$stmt = $pdo->query('SELECT CAST(1 AS int) AS Connected');
if ($stmt->fetch(PDO::FETCH_ASSOC) !== ['Connected' => '1']) {
throw new RuntimeException('Unexpected connection-test result.');
}
echo "Connected on TCP port $port.", PHP_EOL;
} finally {
$stmt = null;
$pdo = null;
}
För SQL_PORT=1433 skriver programmet ut:
Connected on TCP port 1433.
Den hämtade int-typen är en PHP-int i SQLSRV och en sträng som standard i PDO_SQLSRV. Porten är en del av serverargumentet för SQLSRV och en del av Server DSN-nyckelordet för PDO_SQLSRV. Det finns inget separat PDO-nyckelord Port i detta mönster.
Felsök portvalet
| Symtom | Action |
|---|---|
| En namngiven instans fungerar, men en explicit port gör det inte | Bekräfta den faktiska lyssningsporten. Instansen kan använda en dynamisk port som ändrades efter en omstart. |
| TCP får timeout | Kontrollera listenern och brandväggen från PHP-värden. En öppen port bevisar fortfarande inte att SQL-autentisering kommer att lyckas. |
| Validering av certifikatnamn misslyckas efter att en IP-adress använts | Använd värdnamnet på certifikatet med den explicita porten. Inaktivera inte validering för att kompensera för namnändringen. |
| Applikationen ansluter fortfarande någon annanstans | Kontrollera miljön för den körande PHP-processen och den genererade serverinställningen, utan att skriva ut inloggningsuppgifter. Starta om applikationsprocessen om dess konfiguration kräver det. |
TCP-val och instansupptäckt tillhör ODBC och serverns nätverkskonfiguration. PHP tillhandahåller endpointen och rapporterar anslutningsresultatet. För Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, SQL Database in Fabric eller Warehouse in Fabric, behåll den tjänstelevererade endpointen och porten istället för att välja en godtycklig port. SQL-inloggningsprogrammen är inte exempel på autentisering för någon av Fabric-produkterna. För mer information, se Azure och Fabric-anslutningar.